Axi Theme 使用文档

1. 为什么推荐 GitHub + Vercel#

  • PR 预览:每个分支/PR 都能拿到可访问的预览链接
  • 自动构建:push 即部署
  • HTTPS / CDN:默认就有

详细流程与说明:Website on Vercel

2. 部署前检查#

本地先跑通:

pnpm install
pnpm build
bash

配置域名(建议至少填主域名):

  • src/site.config.tstheme.personal.domains.main

3. Vercel 部署要点#

主题会读取 DEPLOYMENT_PLATFORM 来选择适配器与输出:

  • vercel(默认):Vercel adapter,输出通常为 server
  • github:用于 GitHub Pages,输出为 static
  • cloudflare:用于 Cloudflare Pages,输出为 static

在 Vercel 项目里设置环境变量:

DEPLOYMENT_PLATFORM=vercel
txt

构建命令建议使用:

pnpm build
txt

输出目录(Output Directory)保持默认即可(Astro 会由适配器处理)。

4. 静态站点(可选)#

如果你希望生成纯静态站点(例如 GitHub Pages),使用:

DEPLOYMENT_PLATFORM=github
txt

并确保你的部署平台支持静态产物 dist/

GitHub + Vercel 部署(推荐)
https://theme.axi404.top/blog/deploy-vercel
Author Axi Theme
Published at January 11, 2026