Introducing geenius-mvp: the AI-first MVP boilerplate

geenius-mvp is a boilerplate that turns an idea into a deployed full-stack MVP in minutes. You clone the repo, run one CLI, and get a working app: auth, marketing page, themed app chrome, a feature registry, optional features from CRUD to billing to an MCP server, and a one-command deploy to six hosting providers.

The twist is who it is built for. Most boilerplates are written for a human reading docs. This one is written for any AI coding agent — Claude Code, Codex, Cursor, Gemini — and for you. Every command is non-interactive by default, every catalog is machine-readable, and every error names its fix.

The AI-first thesis

When an agent drives your tooling, prose documentation is a lossy interface. Agents do best with three things: a canonical playbook, structured output, and errors that say exactly what to change. geenius-mvp ships all three.

• AGENTS.md is the canonical playbook every agent reads first (CLAUDE.md points there too)
• pnpm new --list --json returns the full capability manifest in one call: types, stacks, dbs, features, layouts, 100 designs, accents, deploy providers
• pnpm doctor --json checks environment readiness, and every failing check includes the exact command that fixes it
• With --json, scaffold and deploy end with a single parseable @geenius-mvp:result line: dir, port, features, next steps, or the live URL

The fast path

pnpm doctor --json          # is this machine ready?
pnpm new --list --json      # the full capability manifest
pnpm new my-idea --type webapp --layout macos --design prism --accent violet \
  --features example,activity,admin
pnpm install
cd apps/my-idea && npx convex dev --once && pnpm dev
cd ../.. && pnpm deploy my-idea --to vercel

Prefer a plain site? pnpm new my-site --type website-blog --stack static gives you HTML plus vanilla CSS with a generated blog and zero build step. One CLI handles both stacks.

What ships in a scaffolded app

A webapp scaffold is not a hello-world. It comes with Better Auth wired to Convex (email plus password, sessions, hosted sign-in), a marketing page for logged-out visitors, and app chrome with a workspace switcher and theming: 100 designs times 18 accents times dark and light, all CSS variables.

Every screen is a FeatureModule. Add a folder, register one line, and routes plus navigation wire themselves. The optional feature pool covers example CRUD, records (the nine-view entity kit), activity, api-keys, team, billing, admin with an audit log, inbox, feedback, AI chat with the key held server-side, uploads, and mcp — which turns your app into its own MCP server with OAuth 2.1. Settings is always on.

You also pick a backend. The default is Convex: reactive queries and the full feature registry. The alternative is an idiomatic Supabase variant where SQL owns the logic and RLS is the API surface — a deliberately different stack, not a port. Both reached full feature parity.

Who it is for

Anyone who wants the distance from idea to live URL measured in minutes: solo builders validating a product, engineers who want the boring 80 percent stamped out so they can spend their tokens and their attention on the domain, and agents that need a substrate they can drive without a human in the loop.

Point any agent at this repo and it can discover and drive everything.

geenius-mvp is the free on-ramp. When your MVP graduates, the full Geenius boilerplate at geenius.dev covers 4 frameworks, 5 or more databases, 15 UI libraries, and 50 production packages — same philosophy, production scale. Over the next week we will publish deep dives on the CLI design, the entity-view kit, the MCP feature, deploy, and the Supabase variant. Start with pnpm new.