Skip to content

全局配置 ​

模板将项目级展示与通用功能集中在 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,每次打包自动生成独立构建编号;详见版本与构建追踪。