Documentation

IdeaKit is a 7-step guided wizard that takes your startup idea from concept to fully provisioned infrastructure. In one session, you'll elaborate your idea with AI, find and register a domain, and provision GitHub, Vercel, and Supabase — all without leaving the browser.

Click "Start a project" from the home page or navigate to /new. The wizard will guide you through each step. You can pause and resume at any point.

Enter your idea in 1-3 sentences. Click "Elaborate →" to have Claude AI generate a full product brief including problem statement, solution, target audience, key features, and positioning.

Claude generates 10 brandable startup names. Each name is immediately checked for availability across .com, .app, .co, .io, and .so using Cloudflare DoH. Select your winner.

AI analyzes your chosen name and idea for market viability. Returns search volume estimate, competition level, top 3 marketing channels, unique angle, risks, and a go/no-go verdict.

Select TLDs to register. Pricing is fetched from Porkbun in real-time. Click "Register" to purchase via the Porkbun API. Requires PORKBUN_API_KEY and PORKBUN_SECRET_KEY.

Enter your API tokens for GitHub (Personal Access Token with repo scope), Vercel (from vercel.com/account/tokens), and Supabase (service role key). Optionally paste a Google Service Account JSON to auto-provision GA4 and Search Console. All are optional.

Watch as IdeaKit creates your GitHub private repo, Vercel project (with domain), Supabase database, GA4 property, and Search Console registration in real-time. Each step shows live status.

All your provisioned resources in one place: domain links, GitHub URL, Vercel deployment URL, Supabase endpoint, GA4 Measurement ID, Search Console verification tag, and suggested next steps.

All API endpoints are available at /api/v1/. Authentication is not yet required for the public API.

List all projects. Returns { projects: [...], total: number }.

Create a new project. Body: { name: string, description?: string }. Returns { project: {...} }.

Get a single project by ID.

Update a project. Body: any fields to update.

IdeaKit exposes an MCP (Model Context Protocol) server at /api/mcp. Use it with Claude or any MCP-compatible AI client.

list_projects — list all projects
get_project — get project with providers
create_project — start a new project from an idea
check_domain — check domain availability
get_provisioning_status — get step statuses

POST /api/mcp
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "method": "tools/list",
  "id": 1
}

ANTHROPIC_API_KEY — Claude API key for idea elaboration, name generation, and SEO analysis.

PORKBUN_API_KEY and PORKBUN_SECRET_KEY — from porkbun.com/account/api. Domain checking works without these.

NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY, SUPABASE_SERVICE_ROLE_KEY — from your Supabase project settings.

GITHUB_TOKEN — default GitHub PAT. VERCEL_TOKEN — default Vercel token. Users can provide their own in Step 5.

GA4 gives you user behavior and traffic analytics. Search Console registers your domain with Google Search and lets you verify ownership — essential for SEO indexing.

1. Go to console.cloud.google.com/iam-admin/serviceaccounts
2. Create a new service account with Analytics Admin and Search Console permissions
3. Generate and download a JSON key
4. Paste the JSON into Step 5 of the wizard

A GA4 property with a web data stream for your domain (returns a G-XXXXXXXXXX Measurement ID), and a Search Console site property with an HTML meta tag for verification.

If you skip the Google Service Account, IdeaKit will show manual setup links in the summary. You can always add GA4 and Search Console later at analytics.google.com and search.google.com/search-console.

After provisioning, copy the G-XXXXXXXXXX ID from the summary. Add it to your Next.js app via the @next/third-parties package or a script tag in app/layout.tsx.