Getting Started

What is Fusion Stack?

Fusion Stack is a CLI + visual builder that lets you compose a project starter from best-in-class tools. Pick your frontend, backend, auth, email, and more — then run one command to get a fully configured, TypeScript-ready project.

pnpm create fusion-stack@latest my-app

Or use the visual builder to pick your stack and copy the generated command.

Quick Start

# Interactive — prompts you for each option
pnpm create fusion-stack@latest

# Next.js + Convex + Clerk (classic)
pnpm create fusion-stack@latest my-app \
  --frontend nextjs \
  --backend convex \
  --auth clerk \
  --email resend

# TanStack Start + built-in API routes + tRPC + Clerk
pnpm create fusion-stack@latest my-app \
  --frontend tanstack-start \
  --backend tanstack-start \
  --auth clerk \
  --api-layer trpc

# TanStack Start + PostgreSQL + Drizzle + Better Auth
pnpm create fusion-stack@latest my-app \
  --frontend tanstack-start \
  --db postgresql \
  --orm drizzle \
  --auth better-auth

# Vite React + Hono + Clerk + tRPC
pnpm create fusion-stack@latest my-app \
  --frontend vite-react \
  --backend hono \
  --auth clerk \
  --api-layer trpc

After generation, the CLI will:

• Write all project files and install dependencies
• Initialise a git repository and create a chore: initial scaffold commit
• Print next steps for environment variables and starting the dev server

To skip git initialisation: add --no-git to the command.

Stack Options

Compatibility Rules

Only a handful of combinations are blocked — everything else can be freely mixed:

• Convex DB requires the Convex backend — selecting Hono, TanStack Start built-in, or no backend removes the Convex database option
• Next.js API Routes backend requires the Next.js frontend — it cannot be used with TanStack Start or Vite React
• TanStack Start (built-in) backend requires the TanStack Start frontend — it is the native API layer of that framework
• Vite (built-in) backend requires the Vite React frontend — Hono runs inside the Vite dev server via configureServer
• shadcn/ui requires any web frontend — it cannot be used in API-only projects

The builder enforces these rules visually. The CLI validates them and adjusts automatically.

Frontend compatibility at a glance

Local URLs