v · 源码事实导向

把后台开发
收敛成一套约定

面向 apps/admin 的新版开发文档。按真实源码讲清启动、路由、权限、请求、主题、通知与部署边界。

正文页面
29
专题模块
7
源码事实导向
100%
apps/admin/src
// 约定式页面 → 自动生成路由
export const Route = createFileRoute(
  '/(base)/home'
)({
  component: HomePage,
  meta: { title: 'home', icon: 'mdi:home' }
});

// 服务 hooks 直接复用
const { data } = useUserList(params)

Built on a modern stack

React 19coreVitebundlerTypeScripttypesTanStack RouterroutingReact QuerydataJotaistateAnt DesignuiUnoCSSstylingReact 19coreVitebundlerTypeScripttypesTanStack RouterroutingReact QuerydataJotaistateAnt DesignuiUnoCSSstyling

// core_features

强大功能,清晰边界

首页只放导读,具体实现进入文档页后按源码路径展开。

文件路由系统

约定式页面结构生成 route tree,菜单、标题与权限随页面同步演进,无需手写路由表。

routeTree.gen.ts

权限与菜单

登录守卫、静态权限、动态菜单与超级角色由启动层统一接入。

guards / permissions

请求服务分层

urls、api、hooks、keys、types 拆分清晰,页面直接复用服务 hooks。

service modules

主题与国际化

暗色模式、主题色、Ant Design 适配、本地图标与语言包统一管理。

theme / i18n

Monorepo 能力

layouts、theme、i18n、notification 以 workspace 包复用。

@skyroc/web-admin-*

开发工具链

Vite、pnpm、类型检查与 devtools 保持清晰启动顺序。

tooling

// read_next

从这里进入开发路径

先跑起来,再看启动链路与路由菜单。首页少讲概念,文档页讲清楚真实代码。

i18n · theme · notification 均已就绪
  1. 01快速开始安装依赖、启动开发环境、构建和预览。
  2. 02启动流程理解 main、bootstrap、App 与 Provider 顺序。
  3. 03路由与菜单新增页面、配置菜单、处理权限与外链。