跳到主要内容

部署与打包 ​

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):

  1. 构建 playground(base=/playground/)
  2. pnpm docs:build:uniapp-demo H5 → admin → h5 → 生成组件文档与 llms.txt → vitepress build → 把 admin/h5/uniapp 示例复制进 dist
  3. 把 playground 复制为 dist/playground/

产物只有一个目录:apps/docs/.vitepress/dist/。

部署到 nginx ​

  1. 把 apps/docs/.vitepress/dist/ 整体上传到服务器,例如 /var/www/ruanno-ui/dist;
  2. 参考仓库 deploy/nginx.conf 配置站点(含五个子路径的 SPA/hash 回退、静态资源缓存、gzip);
  3. 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 产物中(如需可加)。