geenius-mvp

Introduction

geenius-mvp turns an idea into a deployed full-stack MVP in minutes. It is built to be driven by any AI coding agent (Claude Code, Codex, Cursor, Gemini) or by hand: one CLI, non-interactive by default, machine-readable everywhere, validated flags with the fix printed in every error.

What you get per app

  • Auth: Better Auth wired to Convex (email + password, sessions, hosted sign-in)
  • Marketing page for logged-out visitors, plus app chrome: nav, workspace switcher, theming (100 designs x 18 accents x dark/light)
  • Feature registry: every screen is a FeatureModule — add a folder, register one line, routes and nav wire themselves
  • 12 optional features: example, records, activity, api-keys, team, billing, admin, inbox, feedback, ai, uploads, mcp (settings + dashboard are always on)
  • Two backends: convex (reactive platform) and supabase (idiomatic SQL: RLS, triggers, RPCs, Edge Functions)
  • Two stacks: react (Vite + React + shell) and static (plain HTML + JS + vanilla CSS BEM, zero build step)
  • One-command deploy to Cloudflare Pages, Vercel, Netlify, Surge, Heroku, or GitHub Pages

Prerequisites

  • Node.js 20 or newer
  • pnpm (npm i -g pnpm)
  • For the default deploy path: a free Convex account and a free Cloudflare account (login flows launch automatically when needed)

Clone and install

git clone <your-copy-of-geenius-mvp>
cd geenius-mvp
pnpm install
pnpm doctor        # verify the machine is ready

Repo layout

  • AGENTS.md — the canonical playbook for AI agents (and humans); CLAUDE.md points there
  • packages/shell — @geenius-mvp/shell, the reusable engine (linked into every app, no publish step)
  • _template/app, _template/supabase-app, _template/static-site — what pnpm new stamps
  • tools/ — scaffold.mjs (pnpm new), deploy.mjs, doctor.mjs, selftest.mjs, smoke.mjs; shared modules in tools/lib/
  • apps/* — your scaffolded apps
Need more than an MVP? The full Geenius boilerplate at geenius.dev covers 4 frameworks, 5+ databases, 15 UI libraries, and 50 production packages — same philosophy, production scale.