Skip to main content
Vibestrap 把配置分成三层，每一层有清楚的职责。知道改哪一层，能省你大量时间。

​
三层配置

如果你发现自己在改组件源代码来修改文案，停下—— 你应该改的是 messages/{en,zh}.json。

​
siteConfig 控制什么

整个文件大约 250 行。下面是几个关键字段：
每个字段都有内联注释——通读一遍，不用 grep 你就知道哪些能改。

​
siteConfig 之外

这些有自己的家——这是有意为之的。

​
添加一个新功能开关

  1. 加到 siteConfig.features：
  2. 在代码里使用：
完事——不需要其它管道工作。

​
添加一个 env 变量

  1. 在 src/env.ts 加一个 Zod 校验项（密钥放 server section；带 NEXT_PUBLIC_ 前缀、可安全发到浏览器的放 client section）。
  2. 如果是 public 变量，还要加到 experimental__runtimeEnv（Next.js 要求）。
  3. 在环境变量参考里写一笔说明。
  4. 用 import { env } from '@/env' 读取——不要直接 process.env.X。

​
最佳实践清单

  • ✅ 品牌改动只动 siteConfig 和 messages/，不改组件源码。
  • ✅ 密钥只在 .env.local。.env.example 描述结构；真正的 .env.local 已被 gitignore。
  • ✅ 切换 provider（Stripe → Creem）时，改 siteConfig.payment.provider 并设对应的 *_PRICE_* env。代码其他地方不需要关心当前是哪个 provider。
  • ✅ messages/en.json 与 messages/zh.json 永远 key 对齐。 node scripts/check-i18n.mjs 会强制校验。