部署静态站点

文档构建完成后是一组普通 HTML、CSS、JS 和 SVG，运行时不依赖 Node 服务，也不依赖仓库里的 开发服务器。可以直接放到 GitHub Pages、Cloudflare Pages、Netlify 或任何静态文件服务器。

构建

bun install --frozen-lockfile
bun run --filter @ggn/draw docs:build

产物目录：

packages/draw/docs/.vitepress/dist

GitHub Pages

仓库提供了 .github/workflows/draw-docs.yml。在 GitHub 仓库的 Settings → Pages 中选择 GitHub Actions，然后推送默认分支（main / master）即可。

工作流会自动区分两种地址：

仓库类型	站点地址	base
项目仓库 owner/repo	https://owner.github.io/repo/	/repo/
用户站点 owner/owner.github.io	https://owner.github.io/	/

自定义域名也走 GitHub Actions，只需要在 Pages 设置里配置域名；如果站点部署在根路径， 在工作流或构建命令中设置：

DOCS_BASE=/ bun run --filter @ggn/draw docs:build

其他静态网站

以 Cloudflare Pages、Netlify 或普通对象存储为例，配置同一组值：

配置	值
构建命令	bun run --filter @ggn/draw docs:build
输出目录	packages/draw/docs/.vitepress/dist
站点在根路径	不设置 DOCS_BASE，或设为 /
站点在子路径	设为对应前缀，例如 /docs/

构建时会把 base 写进资源 URL，所以部署到子路径时不能继续使用根路径配置。