XiaoDaiGua-Ray 403fdd589a feat!: rebuild Ray Template as a monorepo
Share workspace packages between Ray Admin and the interactive docs.

BREAKING CHANGE: v6 is a new major line. v5 stays on legacy/v5.
2026-11-04 14:01:28 +08:00

35 lines
1.4 KiB
Markdown

# 快速开始
本文使用 Ray Template v6。v5 项目请先查看[版本分界](../migration)。
## 启动工作台
准备 Node.js 26.13.0 和 pnpm 12.16.1。以下以 nvm 为例:
```sh
git clone https://github.com/XiaoDaiGua-Ray/ray-template.git
cd ray-template
nvm install
nvm use
npm install --global pnpm@12.16.1
pnpm install --frozen-lockfile
pnpm env:check
pnpm dev
```
打开 [http://127.0.0.1:9527/ray-template/](http://127.0.0.1:9527/ray-template/),如果端口被占用,以 Vite 输出的地址为准。使用预填表单登录,再打开「表格 → 远端查询与分页」或「布局实验室」。也可直接体验[在线演示](https://xiaodaigua-ray.github.io/ray-template/)。
::: warning 演示与真实业务
预填表单、会话和 Mock 用于展示前端工作流。对外部署真实业务前,接入自己的认证、服务端权限校验和 API。
:::
## 启动文档
在同一个工作区运行 `pnpm docs:dev`。按终端地址打开 `/ray-template/docs/`,可以直接操作 TablePro、条码和布局示例。
## 相关文档
[第一个业务页面](./first-page) · [v5 与 v6 的版本分界](../migration) · [工程检查与部署](./tooling)
[运行时与依赖清单](https://github.com/XiaoDaiGua-Ray/ray-template/blob/main/package.json) · [项目目录与启动链路](https://github.com/XiaoDaiGua-Ray/ray-template/blob/main/docs/architecture.md)