Getting Started

Based Page lets you deploy web content to live URLs - from AI conversations via MCP or directly from your terminal via CLI. Every deploy gets its own subdomain at {slug}.based.page - no backend infrastructure, no build pipeline required.

How It Works

MCP Mode (AI Conversations)

1. Install the Based Page MCP server in Claude Desktop, Claude Code, or Cursor
2. Authenticate once via email OTP
3. Describe what you want in natural language
4. Claude builds & deploys the HTML and gives you a live URL instantly
5. Iterate - update, teardown, or list your deploys from the same conversation

CLI Mode (Terminal)

Deploy directly from your terminal - no MCP client needed:

npx based-page deploy --html '<h1>Hello</h1>' --slug my-page --title "My Page"
npx based-page deploy --file index.html --slug my-site
npx based-page list

What You Can Deploy

• Single HTML files - landing pages, coming soon pages, portfolios
• Multi-file sites - full sites with separate CSS, JS, and images
• React apps - import React from esm.sh with no build step; enable SPA routing with is_spa
• Templates - start from a built-in waitlist or contact template
• Composed pages - assemble from 16 pre-built blocks with 5 style presets

What's Included Automatically

Every deploy gets:

• <title> and meta description injected into the HTML
• Favicon set from the favicon emoji field
• OG tags (og:title, og:description, og:url) for link previews
• Social sharing image - uses your custom og-image.png if deployed, or a default Based Page image

Next Steps

• Installation - Add Based Page to Claude Desktop, Claude Code, or Cursor
• Authentication - Sign in and manage credentials
• First Deploy - Deploy your first page in under a minute

Already installed?

Skip ahead to First Deploy for a quick walkthrough.