Seowebsitesbuilder

DOCUMENTATION

Build a site that ranks, end to end.

This is the complete reference for Seowebsitesbuilder. Read top-to-bottom for a tour, or jump to the section you need.

Quick start

Sign up at /signup. You'll land on the dashboard. Click New project, give it a name, pick a framework (HTML for the fastest start), and click Create.

The editor opens with your starter template already scoring 100/100 on the SEO panel. Edit the title, the meta description, the headline — watch the score update on every keystroke. When you're ready, click Start preview to see your site in a live container, then Deploy to push it to Vercel, Netlify, Cloudflare Pages, GitHub Pages, or any cPanel host.

Total time to your first Lighthouse 100 site: about three minutes.

The editor

The editor has five regions:

  • Header — project name, framework + backend badges, container status, Start/Stop, Terminal toggle, Deploy, Export .zip, GitHub export.
  • File tree — all files in the project (excluding node_modules, .next, dist). Click to open.
  • Monaco editor — same engine as VS Code. Autosaves on every change, 600ms debounce.
  • Preview — live iframe of your running container. Auto-refreshes; click Open in tab for full-page view.
  • Right tabbed pane — switch between the SEO panel (live scoring on the rendered preview) and the AI assistant (chat-to-build).

The terminal lives in a collapsible drawer below the Monaco editor. Toggle it from the header. It opens a real shell inside your project's container, useful for installing dependencies or running build scripts.

SEO scoring engine

Every project is graded against 12 weighted checks. Reaching the 90-point publish threshold means your page has the basics Google rewards:

  • Title tag length 30–60 characters (15 points)
  • Meta description 120–160 characters (15 points)
  • Exactly one <h1> on the page (10 points)
  • At least one supporting <h2> (5 points)
  • All images have meaningful alt text (10 points)
  • <html lang> attribute set (5 points)
  • Canonical link present (5 points)
  • At least three Open Graph meta tags (5 points)
  • Schema.org JSON-LD block present (10 points)
  • Viewport meta for mobile-friendliness (5 points)
  • At most one external render-blocking script (10 points)
  • Page HTML under 100 KB (5 points)

The score updates within ~300ms of every edit. Export is blocked under 90 — you can't accidentally ship a site that won't rank.

Frameworks

Pick one framework per project. The starter you get out of the box already scores 100/100.

  • HTML — plain semantic HTML, zero JavaScript. Fastest TTFB. Best for landing pages, lead magnets, simple content sites.
  • Astro — static-first with optional islands. Content collections, MDX support. Best for blogs and content-heavy sites.
  • Next.js — App Router with static export. Full metadata API. Best when you need React components or server rendering.
  • PHP — runs on any shared host (cPanel, A2, SiteGround). Best when the deploy target is a $3/mo shared hosting plan.

Switching frameworks mid-project means regenerating from the starter — your custom content needs to be ported manually. Pick at creation time when possible.

Backends

Optional. Pick None for a pure static site. Otherwise, one of three database/API patterns will be code-generated into your project at create time:

  • Supabase — auth + Postgres + storage via the official SDK. Migration file, typed client, RLS-friendly query helpers. Connect to your own Supabase project; we never proxy.
  • Postgres — direct connection via pg (Node) or PDO (PHP). Migration file, typed repositories, docker-compose for local dev. Point DATABASE_URL at Neon, Supabase, RDS, Fly Postgres, or self-hosted.
  • Go — idiomatic chi+pgx HTTP API. Multi-stage Dockerfile, distroless runtime image, typed handlers per model.

All generated code is hand-crafted quality with zero dependency on Seowebsitesbuilder runtime. Edit freely.

AI assistant (chat-to-build)

Open the AI tab in the right pane. The assistant has full project context — file list, framework, backend — and can edit any file by emitting fenced code blocks tagged with paths.

Pricing model: bring your own key. Drop an Anthropic or OpenAI API key into your account settings and pay your provider directly. We charge zero token markup. Your token spend is whatever Anthropic or OpenAI bills you.

The assistant's system prompt enforces SEO best practices on every edit: single <h1>, title 30–60 chars, meta description 120–160, schema.org JSON-LD, OG tags, alt text on images, ≤1 external script. Sites it produces score 90+ by default.

Apply edits with the "Apply all" button after each response. You can undo by reverting the saved file from the file tree or via terminal git operations.

Deployment

Five built-in deploy targets. Pick from the Deploy modal in the editor header:

  • Vercel — best for Next.js and Astro. Pass a Vercel API token, optionally a teamId. Vercel runs the build itself.
  • Netlify — static-site CDN with atomic deploys. Pass a Netlify token; we create the site if you don't pass a siteId.
  • Cloudflare Pages — cheapest unlimited static hosting. Pre-create the Pages project in Cloudflare, then pass token + accountId + projectName.
  • GitHub Pages — free static hosting on a gh-pages branch. Public repos only on free GitHub.
  • cPanel / shared hosting — SFTP upload to public_html. Best for PHP. Pass host + username + password (or private key) + the public URL.

Credentials are forwarded to the provider once per deploy. We don't store them.

Publishing on seosites.app

Click Publish to push your project to <slug>.seosites.app behind Cloudflare's CDN. No external account needed; hosting is included on Pro and Agency plans.

For static frameworks (HTML, Astro static, Next.js static export), publish copies your built output to the hosting layer. For PHP and dynamic Next.js, a per-project production container runs persistently (Business add-on).

Custom domains

Available on Pro and Agency. Map any domain you own — point its A record at our hosting IP, or CNAME it at cname.seosites.app. TLS is provisioned automatically via on-demand Let's Encrypt.

Solo includes 3 custom domains, Pro 10, Agency unlimited.

Export to GitHub

Export the full source of any project directly to a GitHub repository you own. From the editor header, click GitHub, paste a personal access token (the repo scope is required), and pick a repo name. We'll create the repo if it doesn't exist and push your project to main as a single commit.

Use this for backups, CI integrations, or to hand off code to a developer outside the platform. Your token is forwarded to GitHub once per export and never stored.

Account & billing

One account, one organization, with three plan tiers:

  • Solo $19/mo — 3 projects, 3 custom domains, 1 seat. For freelancers and side projects.
  • Pro $49/mo — 10 projects, 10 custom domains, 3 seats, priority builds, free publishing on *.seosites.app. For SEO operators running a portfolio.
  • Agency $129/mo — unlimited projects and domains, 8 seats included + $10/extra seat, white-label client deliverables. For SEO agencies and consultancies.

All plans include unlimited LLM usage on your own API key. Cancel anytime; your projects remain accessible for 30 days after cancellation.

Troubleshooting

  • Container won't start — check the terminal for errors. Most common cause: pnpm install failing on a syntax error in package.json.
  • SEO score stuck below 90 — open the SEO panel, look at which checks are red, fix each. Hover the score for the publish threshold.
  • Preview shows 404 — the container probably stopped. Containers auto-stop after 15 minutes of inactivity to keep capacity available; click Start preview again.
  • AI chat returns "No provider configured" — add your Anthropic or OpenAI API key in account settings, then refresh.
  • Deploy fails with auth error — your token expired or lacks scopes. Regenerate with the scopes documented in the Deploy modal.