# Rankforge

> Rankforge is an all-in-one SEO, AEO (AI Engine Optimization), and GEO (Generative Engine Optimization) platform. It helps website owners score and improve their pages for traditional search engines like Google, as well as AI-powered answer engines like ChatGPT, Perplexity, and Google AI Mode.

## About

Rankforge is built for the AI search era. It combines classical SEO analysis with next-generation AI visibility scoring, helping content creators, marketers, and developers ensure their pages rank in Google **and** get cited by AI assistants.

The platform is a web application with a dark, modern UI. Users organize their sites into **workspaces**, add **pages** to track, and run **scans** that produce SEO, AEO, and GEO scores (each 0–100).

## Core Features

- **SEO Scoring**: Comprehensive on-page SEO analysis — title tags, meta descriptions, headings, internal/external links, image alt text, structured data, and more.
- **AEO Scoring**: AI Engine Optimization analysis — evaluates how well a page is structured to be picked up and cited by AI answer engines (ChatGPT, Perplexity, Gemini, etc.).
- **GEO Scoring**: Generative Engine Optimization analysis — measures readiness for generative search experiences like Google AI Overviews and SGE.
- **Keyword Lab**: Keyword research and analysis powered by VebAPI — search volume, CPC, difficulty, and related keyword suggestions.
- **AI Lab**: AI-powered chat assistant for SEO advice, AI citation checking, and content optimization suggestions.
- **Backlink Doctor**: Backlink discovery via VebAPI and domain authority grading via OpenPageRank (0–10 score per referring domain).
- **Google Tools**: Google Search Console integration, Google Trends analysis, and URL indexing submission.
- **Schema Generator**: AI-powered JSON-LD structured data generation and validation.
- **Workspace Management**: Organize multiple websites into workspaces, each with its own pages, scans, and analytics.
- **Quota System**: Free tier included with monthly limits on scans, AI credits, and rank checks. Paid plans via Polar billing.

## Technology Stack

- **Frontend**: React + TypeScript, Vite, Tailwind CSS (shadcn/ui components)
- **Backend**: Supabase (PostgreSQL, Auth, Edge Functions)
- **APIs**: OpenPageRank (domain authority), VebAPI (backlinks, keywords, SERP), Google Search Console, Google Trends
- **Billing**: Polar (subscription management, webhooks)
- **Hosting**: Vercel

## Key Pages

- `/auth` — Sign in or create an account
- `/` — Dashboard with workspace overview, quota usage, and recent scans
- `/workspaces` — List and create workspaces
- `/workspaces/:id/overview` — Workspace overview with page scores
- `/workspaces/:id/pages` — Manage tracked pages
- `/workspaces/:id/pages/:pageId` — Detailed page analysis with SEO/AEO/GEO scores and issue breakdown
- `/workspaces/:id/analytics` — Score trends and analytics charts
- `/workspaces/:id/keywords` — Keyword research lab
- `/workspaces/:id/ai` — AI chat assistant and citation checker
- `/workspaces/:id/google` — Google Search Console, Trends, and indexing tools
- `/workspaces/:id/utilities` — Utility tools hub
- `/workspaces/:id/utilities/backlink-doctor` — Backlink analysis and domain grading
- `/settings/profile` — User profile settings
- `/settings/billing` — Subscription and billing management

## API Endpoints (Supabase Edge Functions)

- `analyze-page` — Runs a full SEO/AEO/GEO scan on a page URL
- `ai-chat` — AI-powered SEO chat assistant
- `ai-citations` — Checks if a URL is cited by AI engines
- `backlink-doctor` — Discovers backlinks (VebAPI) and grades domains (OpenPageRank)
- `check-rankings` — Checks keyword rankings for a page
- `explain-issue` — AI explanation of SEO issues found during scans
- `generate-keywords` — Keyword research and suggestions
- `generate-schema` — Generates JSON-LD structured data for a page
- `verify-schema` — Validates existing structured data markup
- `google-search` — Google Search Console data integration
- `google-trends` — Google Trends data for keyword analysis
- `submit-indexing` — Submits URLs to Google for indexing
- `polar-checkout` — Initiates Polar billing checkout
- `polar-checkout-success` — Handles successful checkout callbacks
- `polar-portal` — Customer billing portal access
- `polar-webhook` — Processes Polar subscription webhooks

## Contact

Rankforge is an open-source project. For more information, visit the application at its deployed URL.