Static Site Builder — Platform Architecture

Agency platform · one wizard → 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 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 ⚠ 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
Agency Userbrowser
↓ JWT auth via CF Access
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

  • • Setup wizard captures business name, phone, address, services, tone, colors
  • • Brand voice baked into every AI prompt — no repeating yourself
  • • AI builds all pages sequentially — one per request, no token limits
  • • Staging link ready to share before the call ends

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 v2