Static Site Builder — Platform Architecture

Agency platform · Jotform intake → approval queue → AI build → staging → live · flat VPS cost, unlimited sites

← scroll to explore →

JWT auth REST AI chat spawn/kill brand voice saved writes files serves git push deploy static files webhook POST preview Cloudflare Access — Zero Trust (team auth / JWT validation) Agency User your team Agency User reviews site CF Access your domain · SSO Platform UI React + Vite Dashboard · Workspace Fastify API Node.js · Docker VPS :3000 SQLite DB sites · users · sessions AES-256-GCM encrypted VPS Workspace — per-site Astro project + dev server Setup Wizard business name · phone 5-min onboarding Dev Server astro dev · per site idle auto-stop AI Providers Claude · GPT · Gemini sequential file-by-file builds Astro Site Files pages · components · assets /sites/[siteId]/ on VPS disk Jotform Intake client self-serve form 79 fields · EEAT · local SEO ⏳ pending_approval brandVoice stored · no scaffold admin reviews → approves approve scaffold ⚠ VPS down? Platform inaccessible Client sites unaffected ✓ GitHub per-site private repo version history · rollback CF Pages staging + live deploys global CDN · free bandwidth Client Websites 100% static · zero runtime custom domains · HTTPS independent of VPS uptime ✓ 💰 Flat VPS cost unlimited sites · no per-seat fees you own the stack ⚡ Sequential AI build one file per request brand voice pre-loaded Legend Frontend Backend / Server Database / AI Cloud / CDN Security Internal async Auth / JWT flow
Agency User
Jotform Intake79 fields · EEAT · local SEO
↓ webhook POST /api/intake/jotform?secret=...
Approval Queue
pending_approvalbrandVoice stored · no scaffold yet
Admin Review Modalall 79 fields visible
Approve / Rejectscaffold fires on approve
↓ approved → scaffold runs → workspace unlocked
Cloudflare Access
Zero Trustyour domain · SSO
JWT validationcryptographic
↓ authenticated request to VPS
Platform UI
React Dashboardmanage all sites
AI Chat Panelbuild & edit
Setup Wizard5-min onboarding
↓ REST API
Backend (VPS · flat monthly cost)
Fastify APINode.js · Docker
SQLite DBAES-256 encrypted
Dev Serverper-site astro dev
AI ProvidersClaude · GPT · Gemini · configurable
↓ sequential file writes — one per request
Astro Site Files
Pages + Components/sites/[id]/ on VPS
Brand Voicepre-loaded into every prompt
↓ git push on every save
GitHub + Cloudflare Pages
Private Repoper site · rollback
CF Pagesstaging + live deploy
Global CDNfree bandwidth · HTTPS
↓ 100% static · zero runtime
Client Websites
Custom domainindependent of VPS ✓
Always liveeven if platform is down

5-Minute Client Onboarding

  • • Jotform intake form (79 fields) — client fills it out, no call needed
  • • Submission creates a pending_approval project — no AI fired yet
  • • Admin reviews all intake data in one modal, clicks Approve
  • • Scaffold runs on approval — workspace opens ready for AI build

Flat Cost vs. Per-Seat SaaS

  • • One VPS — 1 site or 100 sites, same bill
  • • Cloudflare Pages: free bandwidth, unlimited static deploys
  • • No execution costs, no row limits, no per-seat fees
  • • You own the stack — no vendor lock-in, no data in someone else's DB

Client Sites Are Indestructible

  • • 100% static files on Cloudflare's global CDN
  • • Zero runtime — no server, no DB, nothing to crash
  • • VPS can go down for hours — live sites keep serving
  • • Daily DO snapshots = platform recovery in <1 hour

AI Builds, You Review

  • • Sequential file-by-file AI generation — no token limit truncation
  • • Local SEO rules baked into system prompt (JSON-LD, click-to-call, H1 formula)
  • • Chat to refine any page — AI has full brand context
  • • Git commit on every save — one-click rollback

Security Built In

  • • CF Access JWT validation — zero-trust, no VPN needed
  • • All secrets AES-256-GCM encrypted at rest
  • • Magic links (30-min expiry, atomic single-use)
  • • Rate limiting on all auth endpoints

Staging → Live Pipeline

  • • Auto-deploy to CF Pages subdomain on every build
  • • Per-site staging password — share link with client
  • • One-click Go Live — adds real domain, no site rebuild
  • • Form submissions, GA4, Search Console all wired in

static-site-builder platform · architecture v3 — intake integration