网站配置
网站配置
了解 Tanplate 网站配置的层次、源码入口和通用约束。
Tanplate 不使用一个包揽所有选项的 website.ts。配置按职责分为 Manifest、应用适配、表现层组合和严格文案目录，避免把部署能力与一次性 UI 菜单混在同一对象中。
配置结构
| 配置入口 | 职责 |
|---|---|
project.manifest.json | 品牌、应用部署、Capability Profile、Provider 与 locale |
apps/web/src/config | 把 Manifest 映射为 Web 品牌、URL 和构建期 feature gates |
apps/web/src/pages/_app/-components/layout | Header、Footer 与移动菜单 |
apps/admin/src/pages/_app/-components/app-shell-sidebar.tsx | Admin Sidebar 与用户入口 |
apps/*/src/composables/i18n/messages.ts | 菜单、状态和页面显示文案 |
apps/*/src/styles/tailwind.css | 应用级全局语义 token |
配置主题
网站配置
品牌、应用、功能、Provider 和 locale。
导航菜单
Web Header 与移动导航。
页脚菜单
产品、资源、公司和账户链接。
侧边栏菜单
Admin 分组、角色门禁和折叠状态。
头像按钮
Admin 会话入口和登出动作。
社交媒体
公开社交链接与 Social Auth 的边界。
通用规则
- 功能是否进入产物，以 Manifest 和构建 Profile 为准，不用组件内的环境变量临时开关。
- 用户可见文案进入严格 i18n 消息目录，不在菜单数组中维护第二份翻译。
- Web 产品 UI 图标只使用本地 Iconify
i-solar-*/i-carbon-*class；真实品牌标志可以使用i-simple-icons-*。 - 内部链接使用 TanStack Router
Link；外部 URL 使用<a>并明确其外链语义。 - 修改可注释文件时同步 Header 与所属
.folder.md；新增文件或目录时同步成员清单。
完成修改后至少运行：
pnpm init:template
pnpm check:template
pnpm --filter web typecheck
pnpm --filter admin typecheck