Quick Start
The Agent Way (Recommended)
ShipAny vinext is agent-native: open the repo in Claude Code and run the built-in /quick-start skill with a product brief — env config, database setup, landing page, dashboard pages, and module wiring are all handled for you.
/quick-start <what to build — product brief, reference URL, content source, or all three>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,按月订阅When you're ready to ship, run /deploy-cloudflare — local code to live Workers URL in one command.
Manual Setup
Prerequisites: Node.js 22+, pnpm 10 (pnpm 11 is not supported yet).
Install dependencies
pnpm installConfigure environment
cp .env.example .env.developmentOnly five variables are needed to boot:
NEXT_PUBLIC_APP_URL=http://localhost:3000
NEXT_PUBLIC_APP_NAME=My App
DATABASE_PROVIDER=sqlite
DATABASE_URL=file:data/local.db
# Generate with: openssl rand -base64 32
AUTH_SECRET=Initialize the database
pnpm db:pushLocal dev runs on SQLite/PostgreSQL/MySQL; production on Workers uses D1 or Postgres via Hyperdrive (handled by the deploy skill).
Initialize RBAC and the admin user
pnpm rbac:init --admin-email=admin@example.com --admin-password=your-passwordStart the dev server
pnpm devOpen http://localhost:3000, sign in, and visit /admin.
Common Commands
| Command | What it does |
|---|---|
pnpm dev / pnpm build | Dev server / production build (Vite) |
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 run deploy | Deploy to Cloudflare Workers (or just run /deploy-cloudflare) |