chore(docs): add Cloudflare deployment

2026-09-20 16:29:08 +08:00
parent 7d57c9e7ae
commit 2a6284d1b0
4 changed files with 145 additions and 37 deletions
@@ -27,6 +27,16 @@ bun run --cwd docs build

 生成的 `dist` 可以直接部署到静态文件服务。页面在浏览器中使用 hydration 恢复交互，后续站内导航仍由轻量客户端路由处理。

+## Deployment
+
+文档站通过 Cloudflare Workers Static Assets 部署到 <https://react-app-kit.go-slim.dev>：
+
+```sh
+bun run --cwd docs deploy
+```
+
+该命令会先执行完整的静态构建，再通过 Wrangler 发布 `dist`。首次部署前需要使用 `bunx wrangler login` 登录拥有 `go-slim.dev` Cloudflare Zone 的账号；自定义域名、静态路由和 `404.html` 行为均由 `wrangler.jsonc` 管理。
+
 ## Search data

 搜索正文不会打进入口 JavaScript：
@@ -37,4 +47,4 @@ bun run --cwd docs build
 - MDX 页面组件按文章拆分为独立 chunk；
 - 开发模式使用相同的索引生成逻辑，但从 Vite 监听中的 MDX 源文件即时构建。

-新增符合 `packages/<package>/docs/<locale>/**` 目录约定的文档后，无需手工维护搜索列表。
+新增符合 `packages/<package>/docs/<locale>/**` 目录约定的文档后，无需手工维护搜索列表。