mf²

The startup-in-a-command monorepo built for the agent era.

bunx create-mf2-app

Quick Start

bunx create-mf2-app my-app
cd my-app
bun run dev

The CLI scaffolds a Turborepo monorepo with six apps and 20+ shared packages. It prompts for a project name and package manager, copies the template, sets up environment files, installs dependencies, and creates an initial git commit.

Fill in your .env.local files with API keys and start building.

What You Get

Six independently deployable apps that share typed packages:

apps/
  app/            Main SaaS application (Next.js 15, App Router)
  web/            Marketing website
  api/            Webhooks, cron jobs, external integrations
  docs/           Documentation (Mintlify)
  email/          Email templates (React Email)
  storybook/      Component workshop

packages/
  backend/        Convex database, auth sync, AI agents, workflows
  design-system/  50+ shadcn/ui components with dark mode
  auth/           Clerk authentication and route protection
  payments/       Stripe via @convex-dev/stripe
  ai/             Vercel AI SDK, multi-model routing, RAG
  analytics/      PostHog event tracking and sessions
  observability/  Sentry error tracking, BetterStack logging
  security/       Arcjet bot detection, Nosecone secure headers
  rate-limit/     Upstash Redis rate limiting
  storage/        Convex file storage and Vercel Blob
  email/          Resend transactional email
  cms/            BaseHub headless CMS
  seo/            Metadata, JSON-LD, Open Graph
  notifications/  Knock in-app notification feeds
  collaboration/  Liveblocks cursors and presence
  webhooks/       Svix outbound webhook delivery
  feature-flags/  Vercel feature flags with overrides
  internationalization/ next-intl translations
  convex/         Convex + Clerk React provider
  next-config/    Shared Next.js configuration
  typescript-config/ Shared tsconfig

Each app imports only the packages it needs. The main app uses auth, payments, backend, and AI. The marketing site uses CMS, SEO, and analytics. The API layer uses auth, rate-limit, and security.

Stack

Layer	Technology
Framework	Next.js 15 with App Router
Language	TypeScript end-to-end
Database	Convex — real-time, reactive, serverless
Auth	Clerk — 80+ OAuth providers, webhook sync to Convex
Payments	Stripe via @convex-dev/stripe
Styling	Tailwind CSS v4 + shadcn/ui
AI	Vercel AI SDK — multi-model routing, RAG, streaming
Email	Resend + React Email
Analytics	PostHog — events, sessions, feature flags
Error Tracking	Sentry + BetterStack
Security	Arcjet — bot detection, rate limiting, DDoS protection
Monorepo	Turborepo + Bun
Deployment	Vercel
Code Quality	Biome via Ultracite

Convex Components

Five Convex Components ship pre-installed — sandboxed TypeScript modules that manage their own tables and functions inside your Convex backend.

Component	Package	Purpose
Stripe	@convex-dev/stripe	Checkout sessions, subscriptions, customer management, webhook sync
Resend	@convex-dev/resend	Transactional email delivery with event tracking
Workflow	@convex-dev/workflow	Durable, long-running flows with retries and delays
Action Retrier	@convex-dev/action-retrier	Automatic retry with backoff for unreliable external calls
Migrations	@convex-dev/migrations	Schema migrations for live data without downtime

Install more from the component directory:

bun add @convex-dev/rate-limiter

Then register in packages/backend/convex/convex.config.ts:

import rateLimiter from "@convex-dev/rate-limiter/convex.config.js";
app.use(rateLimiter);

Commands

All commands run from the project root.

Development

bun run dev              # Start all apps
turbo dev --filter=app   # Start a single app
bunx convex dev          # Start Convex backend

Code Quality

bun run check            # Lint and format check (Biome)
bun run fix              # Auto-fix issues
bun run convex-lint      # Lint Convex functions (ESLint)

Build and Test

bun run build            # Build all apps
bun run test             # Run tests (Vitest)
turbo build --filter=app # Build a single app

Environment Variables

bun run env:init         # Create .env.local + .env.production from .env.example
bun run env:check        # Validate all env files
bun run env:push         # Sync env vars to Vercel and Convex

Upgrading

bun run bump-deps        # Update all npm dependencies
bun run bump-ui          # Update all shadcn/ui components
bun run clean            # Remove all node_modules

CLI

Pass flags to skip interactive prompts:

bunx create-mf2-app --name my-app --package-manager bun
bunx create-mf2-app --name my-app --disable-git

Flag	Effect
--name <name>	Set project name
--package-manager <manager>	bun (default), npm, yarn, or pnpm
--disable-git	Skip git initialization

For npm, yarn, or pnpm, the CLI converts workspace:* dependencies and adjusts configuration files.

Deploy

Each app deploys as a separate Vercel project:

1. Import your repo at vercel.com/new
2. Set the root directory (apps/app, apps/web, or apps/api)
3. Add environment variables from .env.production
4. Push to main — Vercel rebuilds only affected apps

Documentation (apps/docs) deploys via Mintlify, not Vercel.

Documentation

Full docs at mf2.dev/docs.

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit with conventional commits
4. Open a pull request

License

MIT — Ocarina Labs