外观
全局配置
模板将项目级展示与通用功能集中在 src/config/index.ts。修改这一个入口后,浏览器标题、登录页、导航栏、侧边栏、默认头像、Loading 文案和本地存储命名空间会同步生效。
系统信息
systemInfo 管理应用名称、描述、Logo、favicon 和版权:
ts
systemInfo: {
name: 'Your Product',
description: '产品说明',
logo,
favicon,
copyright: `© ${new Date().getFullYear()} Your Company`
}品牌图片统一从 src/config/assets/images.ts 或静态资源导入,不要在页面组件中重复硬编码路径。
导航配置
navigation 定义首页、登录路由名和页面标题格式:
ts
navigation: {
homePath: '/dashboard/console',
loginRouteName: 'Login',
titleTemplate: '{page} - {app}'
}修改首页时,需要保证 homePath 对应一个真实注册并可访问的路由。
功能开关
features 控制面包屑、工作标签页、主题切换、全局搜索、通知、聊天、水印和示例页面等通用能力。关闭功能时,相关入口和运行时组件会一起停止渲染。
业务权限不属于功能开关。业务角色、菜单权限和后端能力应通过适配层与路由元数据接入。
存储命名空间
ts
storage: {
namespace: 'your-product'
}每个落地项目必须使用独立且稳定的命名空间,避免同域部署的多个系统互相覆盖 LocalStorage 数据。上线后修改命名空间等同于创建一套新的本地状态,需要安排兼容或迁移策略。
环境变量
模板的环境文件位于项目根目录:
| 文件 | 用途 |
|---|---|
.env | 所有环境共享的默认值 |
.env.development | 本地开发覆盖项 |
.env.production | 生产构建覆盖项 |
接口接入常用 VITE_API_URL、VITE_API_PROXY_URL 和 VITE_AUTH_SCHEME。密钥和真实凭证不得写入任何 VITE_* 变量,因为它们会进入浏览器构建产物。
应用发布版本统一读取项目 package.json 的 version,每次打包自动生成独立构建编号;详见版本与构建追踪。