Quick Start

The Agent Way (Recommended)

ShipAny TanStack is agent-native: open the repo in Claude Code and run the built-in /quick-start skill with a product brief. It handles everything — env config, database setup, landing page, dashboard pages, and module wiring.

/quick-start <what to build — product brief, reference URL, content source, or all three>

The skill auto-selects a mode from what you provide:

Mode	You provide	What happens
A	Reference URL + content source	Extracts the reference site's design, pulls content from your source (URL/GitHub repo), generates a pixel-perfect landing page with swapped content, wires up modules
B	Reference URL only	Clones the reference design, rewrites content from your product description
C	Description only	Generates a polished landing page from scratch using modern SaaS patterns

Examples:

/quick-start Build WriteAI, an AI writing tool — design like jasper.ai, content from https://github.com/xxx/yyy
/quick-start 参考 linear.app 做一个项目管理工具
/quick-start 做一个 AI 壁纸生成器,叫 WallpaperAI,用户输入提示词生成壁纸,按月订阅

The agent will ask for anything missing (app name, database choice, domain), then build. Defaults: SQLite + localhost. When you're ready to ship, run /deploy-cloudflare.

Manual Setup

Prerequisites: Node.js 22+, pnpm 10 (pnpm 11 is not supported yet).

Install dependencies

pnpm install

Configure environment

cp .env.example .env.development

Only five variables are needed to boot:

.env.development

VITE_APP_URL=http://localhost:3000
VITE_APP_NAME=My App
DATABASE_PROVIDER=sqlite
DATABASE_URL=file:data/local.db
# Generate with: openssl rand -base64 32
AUTH_SECRET=

VITE_* variables are exposed to the client; unprefixed ones stay server-only.

Initialize the database

pnpm db:push

Default SQLite needs no extra services — see Database for PostgreSQL/MySQL/Turso/D1.

Initialize RBAC and the admin user

pnpm rbac:init --admin-email=admin@example.com --admin-password=your-password

Start the dev server

pnpm dev

Open http://localhost:3000, sign in, and visit /admin.

Common Commands

Command	What it does
`pnpm dev` / `pnpm build` / `pnpm start`	Dev server (port 3000) / build / serve `.output/server/index.mjs`
`pnpm db:setup`	Copy the schema template for `DATABASE_PROVIDER`
`pnpm db:push`	Push schema to the database (development)
`pnpm db:generate` / `pnpm db:migrate`	Generate / run SQL migrations (production)
`pnpm db:studio`	Drizzle Studio GUI
`pnpm rbac:init` / `pnpm rbac:assign`	Seed roles & permissions / assign a role
`pnpm cf:build` / `pnpm cf:deploy`	Cloudflare Workers build / deploy (or just run `/deploy-cloudflare`)

The Agent Way (Recommended)

Manual Setup

Common Commands

On this page