部署与打包
ruanno-ui 的所有可访问应用统一打包成一个静态站点,丢到任意静态服务器即可。推荐布局:
ui.ruanno.top/ → 组件文档站(含应用中心 /apps、llms.txt)
ui.ruanno.top/playground → 组件调试场(主题切换 + 移动视口)
ui.ruanno.top/admin-demo → 管理后台示例(admin / 123456)
ui.ruanno.top/h5-demo → 移动商城示例(建议手机视口)
ui.ruanno.top/uniapp-demo → 97 个组件的 uni-app H5 演示一条命令构建整个站点
bash
pnpm build:site执行内容(scripts/build-site.mjs):
- 构建 playground(
base=/playground/) pnpm docs:build:uniapp-demo H5 → admin → h5 → 生成组件文档与 llms.txt → vitepress build → 把 admin/h5/uniapp 示例复制进 dist- 把 playground 复制为
dist/playground/
产物只有一个目录:apps/docs/.vitepress/dist/。
部署到 nginx
- 把
apps/docs/.vitepress/dist/整体上传到服务器,例如/var/www/ruanno-ui/dist; - 参考仓库
deploy/nginx.conf配置站点(含五个子路径的 SPA/hash 回退、静态资源缓存、gzip); nginx -t && systemctl reload nginx。
HTTPS:模板里已写好 443 server 块(Let's Encrypt 路径示例),证书就位后启用 80→443 跳转即可;纯内网可只用 80 端口块。
与旧 Pages 流程的关系
pnpm docs:deploy 仍然可用(把 docs dist 推到 GitHub/Gitee Pages 的 gh-pages 分支,base=/ruanno-ui/)。两套并存:
- 自己的服务器 / nginx:用
pnpm build:site(本文档流程,五个应用全含); - Pages 静态托管:用
pnpm docs:deploy(沿用原子worktree推送,不动工作区)。
注意:Pages 项目站点部署在 /ruanno-ui/ 子路径下,示例应用路径仍为 …/ruanno-ui/apps/admin/ 等;playground 未包含在 Pages 产物中(如需可加)。