Runlume · 后台设计基线

标准后台设计

从 Runlume 平台前端提取的标准后台模板:语义 Token、布局外壳、公共组件与标准页型。业务系统接自己的菜单、身份与接口即可。

  • MIT 许可
  • v0.1.0
  • React 19 · Vite · Tailwind
  • 零图表库依赖

为什么用这一套

把“每个后台各写一套”的问题收口到一份可复制的基线。

语义 Token 主题

颜色只走语义 Token,六套预设配色 + 基础色 × 主题色自由组合,切主题业务代码零改动。

组件按类型拆分

九类组件页:基础控件、表单、数据展示、反馈、导航、图表、图标、主题与设置。

三种布局外壳

侧边导航、顶部 + 侧边、纯顶部导航;侧栏宽度、圆角、页面过渡、顶栏操作顺序都能调。

零依赖图表

折线、柱状、环形、迷你柱、条形、热力、雷达、漏斗、甘特全部自绘 SVG,跟随语义色与深色模式。

菜单与权限

菜单可来自后台接口:多层级、外链与打开方式、权限码过滤;路由守卫落 403,按钮用 Can 隐藏或置灰。

中英双语与无障碍

语言包单一入口,中英结构由类型强制对齐;键盘可达、焦点管理、高对比、色弱与减少动效。

标准页型

工作台、列表、详情、设置、通知中心、登录注册与找回密码,页面零件统一复用。

命令面板

⌘K 呼出全文搜索:匹配菜单与当前页已渲染内容,支持拼音、路径与键盘操作。

文档站与 AI 友好

VitePress 文档站(构建检查死链)+ pnpm check 一把梭自证,AGENTS.md 与架构决策随代码维护。

组件一览

侧栏「设计系统」下按类型拆分,每个控件都能在应用里直接交互。

快速开始

Node.js 24 + pnpm 11.21.0。

终端
pnpm install
pnpm dev        # 应用 http://localhost:3200
pnpm docs:dev   # 文档 http://localhost:3210
pnpm check      # 格式 + 类型 + lint + 单测 + 构建
  1. 复制目录到业务仓库,改 package.json 的 name。
  2. 换菜单src/app/navigation.ts,或接后台菜单接口。
  3. 换身份src/app/session.ts 的会话与权限码。
  4. 接接口:替换 pages/sample-data.ts,三态用 Loading / Empty / Error。
  5. 换文案与品牌src/lib/i18n.tspublic/brand/