站点、导航与元数据

品牌配置按职责拆分：Nuxt 管理页面与 SEO 元数据，website-config.ts 管理社交与邮件身份，各导航区域则有自己的配置文件。

重要文件

文件	作用
`nuxt.config.ts`	`app.head`、站点身份与 SEO 模块
`app/config/website-config.ts`	社交主页、邮件提供商和地址
`app/config/social-config.ts`	将已配置的社交信息转换为可见链接
`app/config/footer-config.tsx`	营销站页脚分组
`app/config/route-config.ts`	核心 URL 的 `Routes` 枚举
`app/config/user-sidebar-config.ts`	仪表盘/账户导航与角色过滤
`app/config/docs-sidebar-config.ts`	手工维护的文档目录树
`app/config/docs-common-config.ts`	文档代码/文件组件使用的图标映射

website-config.ts 不是元数据的唯一来源。浏览器标题、描述、公开站点 URL 与站点名称目前都在 nuxt.config.ts 中。

站点身份与 SEO

nuxt.config.ts 当前把 app.head.title 设为 SoarStarter Nuxt，把 site.url 设为 https://soar-starter-demo.vercel.app。上线前应连同描述和 site.name 一起替换。

模板安装了 @nuxtjs/sitemap 与 @nuxtjs/robots，其基础站点信息来自 Nuxt site 配置。各页面可用 useSeoMeta/useHead 添加专属元数据。公开域名还应与 NUXT_PUBLIC_BASE_URL 保持一致，避免认证回调、上传 URL、sitemap 与元数据指向不同环境。

社交与邮件身份

websiteConfig.metadata.social 保存社交主页。useSocialLinks() 会跳过空值，并在配置 mail.supportEmail 时加入 mailto: 链接。

同一文件还定义邮件身份：

mail: {
  provider: "resend",
  fromEmail: "Your Product <noreply@mail.example.com>",
  supportEmail: "support@example.com",
}

fromEmail 供 Resend 发件，supportEmail 接收联系表单。生产地址必须先在 Resend 验证域名。

导航配置

route-config.ts 让营销页与页脚共用稳定 URL。
footer-config.tsx 定义产品、资源、公司和法律四组链接。
user-sidebar-config.ts 定义仪表盘、管理、账户和设置入口；其中 roles 只控制菜单可见性，不能替代 API 授权。
docs-sidebar-config.ts 是手工目录；新增 Markdown 不会自动出现在侧栏。
docs-common-config.ts 为文档组件提供文件名/扩展名图标。

内部导航使用 NuxtLinkLocale，这样中文 /zh 前缀不会丢失。新增路由后，同步更新对应配置并验证两种语言。

换品牌检查清单

替换 Logo 组件、favicon 与 public 品牌资源。
更新 app.head 的标题、描述、字体链接，以及各页 SEO/OG 元数据。
替换 site.url/site.name，并对齐 NUXT_PUBLIC_BASE_URL。
替换 website-config.ts 中的占位社交主页。
设置已验证的 fromEmail 与有人值守的 supportEmail。
检查 Routes、页脚、用户侧栏与文档侧栏。
按真实业务重写并审核全部法律内容。
运行 pnpm build，检查标题、规范 URL、sitemap、robots、OG 预览、页脚链接与两种语言。