VibeAny Starter 文档
经源码核对的 VibeAny Starter 配置、扩展与部署指南。
VibeAny 是一个面向生产环境的 Next.js SaaS Starter,已集成身份认证、支付、积分、存储、AI 媒体服务商、国际化和部署工具。
这套文档会带你从收到 Starter 开始,一直完成经过验证的生产部署。所有示例都与当前代码库一致;需要在服务商控制台或基础设施中手动完成的步骤,也会明确标出。
选择你的路径
在本地运行
验证交付包、安装依赖、完成设置,并打开第一个控制台页面。
配置基础能力
配置环境变量、品牌、国际化、PostgreSQL、Better Auth 和邮件。
启用支付
选择 Stripe 或 Creem,配置产品目录,并理解由 Webhook 驱动的履约流程。
定制产品
调整营销页、控制台、博客、存储和 AI 图片生成功能。
部署与运维
运行 preflight、执行迁移、部署到 Vercel,并验证生产环境行为。
查询契约
查找命令、环境变量、架构边界和支持政策。
文档原则
- **任务优先:**围绕完整目标展开,不拼凑彼此无关的代码片段。
- **只使用迁移:**数据库结构变更必须通过经过审查的 SQL 迁移完成;基于 push 的结构变更已被禁用。
- **以服务商状态为准:**重定向只能证明页面跳转成功;签名 Webhook 和数据库状态才是支付履约的证明。
- **明确边界:**对于可选服务商和部署自动化,只记录 Starter 当前已经验证的能力。
英文为源
英文文档始终是事实来源。中文翻译只有在完成翻译,并针对同一 Starter 版本核对后才会发布。如果两种语言存在差异,请以英文页面和对应版本的源码为准。