方案简介

Astroship 是一个免费开源的 Astro 起步模板，面向 SaaS、创业公司、营销网站、落地页与博客场景。整套技术方案由 Astro 框架与 TailwindCSS 组合而成，仓库中 TailwindCSS 已完成预配置，克隆即可直接使用，无需额外安装。模板支持通过 GitHub 的 "Use this template" 按钮快速创建自己的仓库，并可通过 Vercel 或 Netlify 一键克隆部署上线。免费版本采用 GPL-2.0 许可证，包含 Astro v3、Content Collections、Tailwind CSS、移动端响应式与可用联系页等能力；官方另有 $49 的 Pro 版本提供 Pro 布局、带分页博客、View Transitions、特性页、集成页与优雅 404 页等增强功能。适合希望快速搭建现代静态官网与博客的创业者、独立开发者与营销团队。

亮点与能力

根据 README 的功能对比表，免费版本包含以下能力：

• Astro v3：基于 Astro 3.x 构建
• Content Collections：内置内容集合支持
• Tailwind CSS：预配置的实用类样式方案
• Mobile Responsive：移动端响应式布局
• Working Contact Page：可用的联系页面
• Free Updates：免费更新

Pro 版本额外提供：Pro Layouts & Features、Blog with Pagination、View Transitions、Advanced Homepage Design、Features Page、Integrations Page、Elegant 404 Page、6 Months Support 等。

组成与分工

• Astro：核心静态站点框架，基于文件路由，在 src/pages/ 中寻找 .astro 或 .md 文件生成路由；支持 Content Collections 管理内容
• TailwindCSS：样式方案，仓库中已预配置，无需安装即可使用
• pnpm：官方推荐的包管理器，用于安装依赖与运行脚本，可节省磁盘空间
• Vercel / Netlify：部署平台，通过 README 中的按钮一键克隆到 GitHub 并部署
• GitHub：代码托管与模板分发渠道，可通过 "Use this template" 快速复用

前置要求

需要本地具备 Node.js 环境与 npm/yarn/pnpm 包管理器（README 推荐 pnpm 以节省磁盘空间）。获取代码有两种方式：

1. 在 GitHub 上点击 "Use this template" 按钮创建新仓库，再 git clone 到本地；
2. 直接克隆本仓库。

安装依赖：

bash
npm install

or

yarn install

or (recommended)

pnpm install

实施步骤

1. Clone the repo

bash
git clone https://github.com/surjithctly/astroship.git myProjectName

or

git clone https://github.com/surjithctly/astroship.git .

. 会将项目克隆到当前目录，因此请先确认已进入你的项目文件夹。

2. Install Dependencies

bash
npm install

or

yarn install

or (recommended)

pnpm install

3. Start development Server

bash
npm run dev

or

yarn dev

or (recommended)

pnpm dev

Preview & Build

bash
npm run preview
npm run build

or

yarn preview
yarn build

or (recommended)

pnpm preview
pnpm build

使用与配置要点

• 启动开发服务器后即可在本地预览站点；使用 npm run preview / pnpm preview 可预览构建产物，npm run build / pnpm build 生成生产版本
• 页面路由：Astro 在 src/pages/ 目录中寻找 .astro 或 .md 文件，每个文件按文件名暴露为一条路由
• 静态资源：图片等静态资产放在 public/ 目录
• 样式：TailwindCSS 已配置完毕，直接使用即可，无需安装
• 扩展 Astro 能力可使用：

bash
pnpm astro ...
pnpm astro add
pnpm astro --help

• 一键部署：点击 README 中的 Vercel 或 Netlify 部署按钮，可即时克隆到自己的 GitHub 并部署上线

注意事项与常见问题

• 项目结构约定：public/、src/components/、src/layouts/、src/pages/ 与 package.，修改页面主要在 src/pages/ 内进行
• 免费版与 Pro 版的功能差异较多（分页博客、View Transitions、404 页等仅 Pro 提供），Pro 为商业许可（$49），免费版为 GPL-2.0
• 想深入学习的可查阅 Astro Docs 或加入官方 Discord Chat

优缺点

• ✓ 预配置开箱即用
• ✓ 可一键部署免费上线
• ✕ Pro 功能需付费 $49
• ✕ 免费版无分页博客等功能

出处

本方案挖掘自开源项目 surjithctly/astroship，方案内容与实施命令均来自其 README 原文。