geenius-mvp

Idea to deployed MVP in minutes — with any AI agent at the wheel

One CLI scaffolds auth, teams, billing, MCP and 100+ designs — driven by Claude Code, Codex, Cursor, Gemini, or you — then deploys anywhere in one command.

Read the docs Explore Geenius →

Machine-readable everywhere
2 backends, 2 stacks
12 optional features
6 deploy targets

Built for AI agents

Every surface is machine-readable

Point any coding agent at the repo and it can discover and drive everything on its own — no prompting archaeology, no guessing at flags.

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

agent session

$ pnpm new my-idea --type webapp --design prism \
    --accent violet --features records,team,mcp --json
✓ scaffolded apps/my-idea (convex · react · sidebar)
@geenius-mvp:result {"ok":true,"slug":"my-idea",
  "dir":"apps/my-idea","port":5173,
  "features":["records","team","mcp","api-keys","settings"],
  "next":["pnpm install","npx convex dev --once","pnpm dev"]}

Pick your features

12 optional features, one flag each

Settings and the dashboard are always on. Everything else is a --features choice — each one a self-contained module the registry wires into routes and nav automatically.

🧪

example

The reference CRUD pattern to clone for your own screens.

🗂️

records

Generic data points wired to the 9-view entity kit.

📈

activity

A workspace activity feed of what happened, when.

🔑

api-keys

Issue and revoke keys for programmatic access.

👥

team

Members and invites for shared workspaces.

💳

billing

Stripe-ready plans, checkout and webhooks.

🛡️

admin

User management plus an audit log.

📥

inbox

In-app notifications and messages.

💬

feedback

Collect user feedback right inside the app.

✨

ai

Claude chat built in — the API key stays server-side.

📎

uploads

File uploads backed by your chosen backend's storage.

🔌

mcp

Your app becomes an MCP server: OAuth 2.1 for chat apps, API keys for dev tools, interactive UI resources.

The entity-view kit

One config, nine views

One field config powers nine interchangeable views. Add a dateKey and timeline + calendar light up; an imageKey unlocks the gallery; a positionKey unlocks the draggable canvas. Sorting, kanban drag, and month paging come for free.

Your stack, your call

Every axis is a flag

2 backends

Convex — reactive platform with the full feature registry. Supabase — idiomatic SQL: RLS as the API surface, triggers, RPCs, Storage, Edge Functions.

2 stacks

React — Vite + React + the shell. Static — plain HTML + CSS with BEM naming, zero build step. One CLI handles both.

5 site types

webapp · website · website-blog · website-blog-docs · single-page. Public sites need no backend at all.

4 app layouts

sidebar · header · windows desktop · macos desktop — all slot-based.

100+ designs × 18 accents

Chrome theming is pure CSS variables: 100+ designs, 18 accents, dark and light. Run pnpm new --list for the full catalog.

One command, deployed anywhere

pnpm deploy my-idea — login flows launch automatically, the backend deploys first and never duplicates, SPA fallbacks are written per provider, and your choice is remembered.

Cloudflare Pages Vercel Netlify Surge Heroku GitHub Pages

Quickstart

Clone the repo, then the fast path is five commands.

geenius-mvp

$ 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
# local and live. Ready to ship?
$ cd ../.. && pnpm deploy my-idea --to vercel
# or a plain HTML+CSS site — no backend, no build step:
$ pnpm new my-site --type website-blog --stack static --accent teal

Built to be outgrown

When your MVP graduates

geenius-mvp is the free on-ramp. The full Geenius boilerplate covers 4 frameworks, 5+ databases, 15 UI libraries, and 50 production packages — same philosophy, production scale.

Explore Geenius →