用途:在当前目录从零搭建一个可部署的 Astro 站点,覆盖开发环境与生产部署配置。
主要能力:使用 Astro v5 与 TypeScript 严格模式;通过 Vite 插件接入 Tailwind CSS v4;集成 React、Sitemap;开发环境接入 Tidewave 供 AI 智能体使用;用 Partytown 加载 Google Analytics(仅生产环境);提供 Kamal 部署配置、Nginx 静态文件服务与 Docker 多阶段构建。
使用方式:先用 bun create astro@latest . --template minimal --typescript strict --git --install 初始化,再安装 @astrojs/react、@astrojs/sitemap、@astrojs/partytown、react、react-dom、tailwindcss、@tailwindcss/vite 及开发依赖 tidewave。随后按资料配置 astro.config.mjs、全局 CSS、基础布局、Google Analytics 组件、生产配置 astro.config.node.mjs、package.json 脚本、config/deploy.yml、Dockerfile、nginx.conf、.dockerignore、.env.example 与首页。开发命令为 bun dev、bun run build、bun run preview、bunx astro check;部署需 gem install kamal,首次 kamal setup,之后 kamal deploy,可用 kamal app logs -f 查看日志、kamal rollback 回滚。
适用场景:需要快速建立带 React、Tailwind、站点地图、分析统计与容器化部署的 Astro 静态站点项目。
限制与注意:资料要求替换 your-domain.com、your-app-name、your-username、your-github-username、服务器 IP、GA4 测量 ID 等占位值;生产配置需保持 trailingSlash: 'always' 并在 Nginx 中关闭端口重定向,以避免端口泄漏;Google Analytics 仅在 import.meta.env.PROD 时加载。资料未提供具体收费、价格或效果数据。