ENTITYFORGE PLATFORM BUILD BRIEF
Last updated: May 2026

=== WHAT THIS SITE IS ===

EntityForge is an AI Visibility Platform for local service businesses.
It generates the complete suite of AI-readable files that help businesses
get found and accurately cited by ChatGPT, Perplexity, Claude, Gemini,
and other AI answer engines — then hosts those files at a permanent hub URL.

Production URL: https://entityforge.app
App workspace:  https://entityforge.app/app
Demo:           https://entityforge.app/demo
Pricing:        https://entityforge.app/pricing
Hub example:    https://entityforge.app/hub/aigigs-me

=== WHO IT SERVES ===

Local service businesses in any category (legal, medical, home services,
AI services, contractors, etc.) who need structured AI visibility:
- Small businesses wanting to appear in AI-generated answers
- Marketing agencies managing multiple client hubs
- Enterprise teams with multiple locations

=== CORE FEATURES ===

1. Intake Form — collects: business name, website, category, phone,
   address, summary, services, key people, proof points, service areas

2. AI Corpus Generator — produces 9 files from the intake form:
   schema.jsonld, key-people.md, services-guide.md, faq.md, llms.txt,
   llms-full.txt, robots.txt, sitemap.xml, build-brief.txt

3. Website Scanner — scans a business URL, scores AI readiness,
   pre-fills intake form from existing site content

4. Hub Publishing — one-click publish to a permanent hosted URL
   with CDN-bypass no-cache headers for AI bots

5. Hub Analytics — logs AI bot crawls (GPTBot, ClaudeBot, PerplexityBot,
   Gemini, Bingbot, etc.) per hub, deduplicated daily

6. Multi-Workspace Dashboard — manage multiple business hubs per account

7. Download All Files — zip download of all 9 generated files

=== TECHNICAL STACK ===

Frontend:   React 19 + Vite, Tailwind CSS v4, shadcn/ui, wouter, TypeScript
Backend:    Express 5 (Node.js 24), port 8080
Database:   PostgreSQL + Drizzle ORM
Auth:       localStorage-based (ef_user, ef_passwords keys)
Payments:   Stripe (via Replit integration)
Email:      Resend (via Replit integration)
Build:      esbuild (CJS bundle for API), Vite (frontend)
Workspace:  pnpm monorepo

=== KEY ROUTES ===

Frontend pages:
  /           Landing page
  /app        Main workspace (form + generators + hub publish)
  /hubs       Multi-workspace dashboard
  /demo       Read-only demo of the workspace
  /pricing    Stripe pricing plans
  /signup     Account creation
  /login      Sign in
  /admin      Admin panel (lgjhost@gmail.com only)

API routes (base: /api):
  GET  /api/healthz            Health check
  POST /api/scrape             Website scanner
  GET  /api/hubs/:slug         Hub file server
  GET  /api/hubs/:slug/:file   Specific hub file
  GET  /api/hubs/:slug/analytics  Crawl analytics
  GET  /api/workspaces         Fetch server-side workspace data
  PUT  /api/workspaces         Save server-side workspace data
  POST /api/stripe/checkout    Stripe checkout session
  GET  /api/sitemap.xml        Dynamic sitemap

=== AI-READABLE FILES INDEX ===

  /robots.txt       — Bot permissions + sitemap references
  /llms.txt         — Concise AI crawler index
  /llms-full.txt    — Full plain-text corpus for answer engines
  /build-brief.txt  — This file — technical brief for AI agents
  /faq.md           — Q&A pairs for AI citation
  /key-people.md    — Team entity signals
  /services-guide.md — Service catalog
  /schema.jsonld    — Full Schema.org @graph entity graph
  /ai-sitemap.xml   — Static sitemap of all AI-readable files
  /api/sitemap.xml  — Dynamic sitemap of all pages

=== SITEMAPS ===

  https://entityforge.app/api/sitemap.xml  (dynamic — Google/Bing)
  https://entityforge.app/ai-sitemap.xml   (static — AI crawlers)

=== CONTACT ===

  Website: https://entityforge.app
  Admin:   lgjhost@gmail.com