品牌配置
替换产品名称、Logo、首页文案，并选择要开放的应用功能。
把已经运行的应用换成你的产品。先改名称和 Logo，再写首页文案，最后决定要展示哪些功能。
开始前准备
完成 快速开始，保持本地服务运行。准备产品名称、一句话介绍、Logo 与支持邮箱。本文文件路径相对于当前应用根目录。
1. 设置产品名称
打开 packages/config/src/i18n.ts，在两种语言的条目中替换：
| 字段 | 用户在哪里看到它 |
|---|---|
appName | Logo 旁的名称与产品身份 |
summary、description、keywords | 公开元数据与产品描述 |
docsAlias | 文档标题 |
保留原有语言键和外层结构。分别填写中英文介绍，不要只改一种语言。
2. 替换图片
在所选应用的 public/ 中替换：
| 文件 | 用途 |
|---|---|
icon.png | 页头 Logo 与默认邮件 Logo |
favicon.ico、favicon.svg、favicons/* | 浏览器与安装应用图标；favicons/og.png 为社交分享图 |
images/hero-light.png、images/hero-dark.png | 首页的产品截图 |
沿用文件名可以继续使用现有引用。亮色、暗色截图都要检查。
3. 写你的首页文案
产品文案只放在 两语言的 packages/i18n/src/translations/en/mvp.json 和 zh/mvp.json。保留 default.json，方便后续合并模板更新。
下面使用首页真实读取的键。将它合并进已有 mvp.json，不要覆盖其他文案：
{
"home": {
"hero": {
"mainTitle1": "Acme",
"mainTitle2": "把灵感变成完成的作品",
"mainDescription": "为你的下一个产品准备的工作空间。"
}
}
}英文文件用相同键填写英文内容。导航、FAQ 和邮件主题也用同样方式覆盖，详见 语言与翻译。
4. 设置语言与支持邮箱
编辑应用 .env.local：
NEXT_PUBLIC_SITE_URL="http://localhost:3000"
NEXT_PUBLIC_DEFAULT_LOCALE="zh"
NEXT_PUBLIC_EMAIL_SUPPORT="[email protected]"
CONTACT_FORM_TO="[email protected]"英文优先的产品使用 en。开发时保留本地 origin，部署时换成 HTTPS 域名。本地运行文件见 环境变量。环境变量修改后重启开发服务。
CONTACT_FORM_TO 是接收联系消息的邮箱。要真正发出消息，还需配置 邮件。
5. 选择应用功能
在 packages/config/src/index.ts 修改现有 config，不要用局部示例替换整个对象。
| 你想调整什么 | 设置 |
|---|---|
| 收费尚未准备好，先隐藏定价 | payments.enableBilling = false |
| 展示免费或企业套餐 | payments.enableFree、payments.enableEnterprise |
| 首次登录需要引导 | users.enableSetup |
| 展示密码、社交登录与 2FA 控件 | auth.gates.allowPasswordSignIn、allowSocialSignIn、allowTwoFactorAuth |
| 默认深色 | ui.defaultTheme = "dark"，同时 ui.enabledThemes 包含 dark |
| 展示注销账号入口 | users.showDeleteAccount |
认证展示开关不替代后端权限校验。价格在应用 src/config/saas/pricing-desc.ts 与 pricing-desc-usage.ts 中配置，然后 接入支付网关。
不需要的首页区块和导航链接直接在组件中移除，见 自定义落地页。关闭计费会隐藏首页定价，并让 /pricing 返回首页。
确认结果
- 刷新首页，确认 Logo、名称与主视觉文案已替换。
- 切换语言，检查浏览器元数据、页头、页脚和支持邮箱。
- 检查亮色和暗色模式。
- 关闭计费后，确认首页无定价区，访问
/pricing返回首页。
常见问题
| 问题 | 处理方式 |
|---|---|
| 页头名称变了，首页仍是 MuseMVP | 除语言元数据外，还需在两语言 mvp.json 覆盖 home.hero.* |
| 环境变量改了没生效 | 重启开发服务；部署环境修改 NEXT_PUBLIC_* 后重新构建 |
| 浏览器仍显示旧 favicon | 强制刷新或用新浏览器会话检查，并确认所有被引用图标已替换 |
| 隐藏链接后 URL 仍能访问 | 移除导航不会删除路由；只有 URL 也不应开放时，才移除对应路由 |