从零启动一个 ShipAny 项目

从零启动一个 ShipAny 项目，真正容易出错的不是命令，而是环境变量与数据库的对应关系。

安装与 env

pnpm install 之后，复制 .env.example 为 .env.development，写入 VITE_APP_URL、DATABASE_PROVIDER、DATABASE_URL 和 AUTH_SECRET。开发期以 .env.development 为准，Vite 和 db 脚本都按 NODE_ENV 读取它。

数据库

默认 SQLite 零配置。换 Postgres 或 MySQL 时先运行 db:setup 复制对应 schema，再 db:push。schema.ts 是本地工作副本，不要提交。

验证

pnpm dev 启动后，用默认管理员登录 /admin，先确认登录、配置、上传三条链路都通，再写业务。

常见坑

AUTH_SECRET 为空会导致会话异常；DATABASE_URL 的路径写错时 db:push 会新建空库，看起来像数据丢了。