品牌化
单一品牌化入口是 src/config/app.ts(appConfig)。该配置被侧边栏(Logo + 名称 + 导航)、根文档头部(标题 + 描述)、主题提供程序以及认证页面(品牌页头)所使用。其他任何地方不应硬编码产品名称或 Logo。
步骤
-
编辑
src/config/app.ts:name— 产品名称(侧边栏、<title>、认证页头)。description—<meta name="description">。logo— 任意 Phosphor 图标组件(例如import { RocketIcon })。theme—{ defaultTheme: "light" | "dark" | "system", enableSystem }。
-
导航位于
src/lib/sidebar-items.ts(mainMenuItems、bottomMenuItems),通过appConfig.nav暴露。可添加/删除/重新排序项目;保留// create-resource:anchor这一行(生成器会在此行之上插入内容)。 -
主题令牌(颜色)是
src/styles/app.css中的 CSS 变量(--primary、--chart-1..5等),针对亮色和.dark模式。图表和状态芯片会自动跟随主题变化。
验证
运行 bun run check,然后加载应用:侧边栏、浏览器标签页标题以及登录页面都应显示新的品牌信息。appConfig 的单元测试会断言导航的不变约束(src/config/app.test.ts)。