astro-setup

majiayu000 的头像作者 majiayu000

Astro 项目初始化和配置模式。在设置新的 Astro 项目或配置 Astro 功能时使用。

📖 中文导读:Astro 项目初始化和配置模式。在设置新的 Astro 项目或配置 Astro 功能时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: astro-setup description: Astro project initialization and configuration patterns. Use when setting up new Astro projects or configuring Astro features.

Astro Setup Skill

Project Initialization

npm create astro@latest project-name -- --template minimal --typescript strict
cd project-name

Essential Integrations

npx astro add react
npx astro add mdx
npx astro add tailwind

Configuration Pattern

// astro.config.mjs
import { defineConfig } from 'astro/config';
import react from '@astrojs/react';
import mdx from '@astrojs/mdx';
import tailwind from '@astrojs/tailwind';

export default defineConfig({
  site: 'https://username.github.io',
  base: '/repo-name', // or '/' for user pages
  integrations: [react(), mdx(), tailwind()],
  output: 'static', // Required for GitHub Pages
  image: {
    service: {
      entrypoint: 'astro/assets/services/sharp'
    }
  }
});

Content Collections

Content collections go in src/content/ with a config.ts file defining schemas using Zod.

Best Practices

  • Use output: 'static' for GitHub Pages
  • Configure site and base for proper asset paths
  • Enable image optimization
  • Keep integrations minimal