Custom Sites

You don't need templates or blocks. Describe any page you want and Claude will generate the HTML and deploy it live.

How It Works

Tell Claude what you need in plain English:

"Build me a personal portfolio page with a bio section and project links."

"Create a coming soon page for my SaaS with a countdown timer to April 1."

"Deploy a simple HTML page at the slug 'my-project'."

Claude generates a complete HTML document and calls deploy. The page is live immediately.

Requirements Gathering

For vague requests, Claude may call gather_requirements to ask a few targeted questions first:

You: "I need a page for my business"

Claude: "A few quick questions: What's the business? What should visitors do on the page? Any specific branding or colors?"

You can skip this by providing detailed specs upfront, or by saying "just build it with your best judgment."

Slug Selection

You can specify a custom slug or let Based Page generate one:

• Custom: "Deploy this to my-project" creates my-project.based.page
• Auto-generated: "Deploy this page" assigns a random slug like bright-forest-x7k2.based.page

Slugs must be lowercase and may contain hyphens. They must be unique across all deployments.

What Claude Generates

Claude produces complete, self-contained HTML documents:

• Inline CSS — no external stylesheets required (though CDN links work fine)
• Inline JavaScript — client-side logic included in the document
• CDN libraries — Tailwind, Alpine.js, Lenis, and any other CDN packages via script tags

Updating a Custom Site

"Update my project page — add a contact section at the bottom."

Claude calls update with the deployment ID and revised HTML. The URL stays the same; the content updates immediately.

Custom Slug Example

"Deploy a 'coming soon' page for my app called Beacon. Use the slug 'beacon-launch'."

Claude generates the HTML and calls deploy with slug: "beacon-launch". The page goes live at beacon-launch.based.page.

Notes

• For sites with multiple files (separate CSS, JS, images), use Multi-file Deploys.
• For React apps, see React & Frameworks.
• There is no build step — serve HTML directly, link to CDN assets, or use multi-file deploys for local assets.