ShipAny Docs

快速开始

Agent 方式(推荐)

ShipAny Next 是 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。

手动初始化

前置要求:Node.js 22+pnpm 10(暂不支持 pnpm 11)。

安装依赖
pnpm install
配置环境变量
cp .env.example .env.development

启动只需要五个变量:

.env.development
NEXT_PUBLIC_APP_URL=http://localhost:3000
NEXT_PUBLIC_APP_NAME=My App
DATABASE_PROVIDER=sqlite
DATABASE_URL=file:data/local.db
# 生成方式:openssl rand -base64 32
AUTH_SECRET=
初始化数据库
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)/ 构建 / 运行
pnpm db:setupDATABASE_PROVIDER 复制 schema 模板
pnpm db:push推送 schema 到数据库(开发环境)
pnpm db:generate / pnpm db:migrate生成 / 执行 SQL 迁移(生产环境)
pnpm db:studioDrizzle Studio 图形界面
pnpm rbac:init / pnpm rbac:assign初始化角色与权限 / 分配角色