快速开始
前置准备
环境要求：
bash
node -v
pnpm -v
git -vTIP
Windows 开发环境请直接使用项目声明的 pnpm 版本；避免可能切换错误版本的 Corepack 包装命令。
获取源码
bash
git clone https://github.com/cuteyuchen/lumal.git
cd lumalWARNING
存放代码的目录及父级目录避免中文、空格等非常规路径，减少工具链异常。
安装依赖
bash
pnpm install运行示例
Admin + Mock
bash
pnpm admin:dev并行启动 lumal-mock-api 与 lumal-admin。开发期通过 @lumal/vite 的 source alias 直接解析 packages/*/src，无需先构建各包。
全部 apps（并行）
bash
pnpm apps:dev文档站
bash
pnpm docs:dev
# 等价：pnpm --filter lumal-docs dev浏览器打开 http://127.0.0.1:5173。
其他常用命令
bash
pnpm --filter lumal-cockpit dev
pnpm --filter lumal-datav-guide dev创建业务项目
当前已发布版本为 0.0.4-beta，以下命令显式指定版本：
bash
pnpm create lumal-admin@0.0.4-beta my-admin
# HTTP API 模式
pnpm create lumal-admin@0.0.4-beta my-admin-http --api-mode http
cd my-admin
pnpm install
pnpm dev详见 脚手架项目 与 create-lumal-admin。
应用侧最小接入
ts
import { createLumalAdmin } from '@lumal/core/minimal'
import App from './App.vue'
await createLumalAdmin({
rootComponent: App,
}).mount('#app')该入口不安装默认 UI 注册表；使用布局、表单等 UI 时，显式安装对应 peer、组件和样式。脚手架已包含带 Element Plus 的后台基座接线。完整选项见 @lumal/core 与 Core API，升级说明见 更新日志。