快速开始
Agent 方式(推荐)
ShipAny TanStack 是 agent-native 的:用 Claude Code 打开仓库,运行内置的 /quick-start skill,给一段产品简介即可。env 配置、数据库初始化、Landing Page、Dashboard 页面、模块接线全部由它完成。
/quick-start <要做什么 —— 产品简介、参考站 URL、内容来源,可任意组合>skill 会根据你提供的内容自动选择模式:
| 模式 | 你提供 | 执行内容 |
|---|---|---|
| A | 参考站 URL + 内容来源 | 提取参考站设计,从内容源(URL/GitHub 仓库)抓取文案,生成像素级 Landing Page 并替换内容,接线模块 |
| B | 仅参考站 URL | 克隆参考站设计,按你的产品描述重写文案 |
| C | 仅产品描述 | 按现代 SaaS 设计模式从零生成 Landing Page |
示例:
/quick-start 做一个 AI 写作工具叫 WriteAI,参考 jasper.ai 的网站风格,内容参考 https://github.com/xxx/yyy 的 README
/quick-start 参考 linear.app 做一个项目管理工具
/quick-start 做一个 AI 壁纸生成器,叫 WallpaperAI,用户输入提示词生成壁纸,按月订阅缺少的信息(应用名、数据库选型、域名)agent 会主动询问,默认 SQLite + localhost。准备上线时,运行 /deploy-cloudflare。
手动初始化
前置要求:Node.js 22+、pnpm 10(暂不支持 pnpm 11)。
安装依赖
pnpm install配置环境变量
cp .env.example .env.development启动只需要五个变量:
VITE_APP_URL=http://localhost:3000
VITE_APP_NAME=My App
DATABASE_PROVIDER=sqlite
DATABASE_URL=file:data/local.db
# 生成方式:openssl rand -base64 32
AUTH_SECRET=VITE_* 变量会暴露给客户端;无前缀变量仅服务端可见。
初始化数据库
pnpm db:push默认 SQLite 无需额外服务——PostgreSQL/MySQL/Turso/D1 见数据库。
初始化 RBAC 与管理员账号
pnpm rbac:init --admin-email=admin@example.com --admin-password=your-password启动开发服务器
pnpm dev打开 http://localhost:3000,登录后访问 /admin。
常用命令
| 命令 | 作用 |
|---|---|
pnpm dev / pnpm build / pnpm start | 开发服务器(端口 3000)/ 构建 / 运行 .output/server/index.mjs |
pnpm db:setup | 按 DATABASE_PROVIDER 复制 schema 模板 |
pnpm db:push | 推送 schema 到数据库(开发环境) |
pnpm db:generate / pnpm db:migrate | 生成 / 执行 SQL 迁移(生产环境) |
pnpm db:studio | Drizzle Studio 图形界面 |
pnpm rbac:init / pnpm rbac:assign | 初始化角色与权限 / 分配角色 |
pnpm cf:build / pnpm cf:deploy | Cloudflare Workers 构建 / 部署(也可直接用 /deploy-cloudflare) |