Astro

# プロジェクト名

Astro 5 で構築されたコンテンツサイト / ドキュメントサイト。

## 技術スタック

- **フレームワーク**: Astro 5.x
- **言語**: TypeScript 5.x
- **コンテンツ**: Astro Content Collections + MDX
- **スタイリング**: Tailwind CSS v4
- **パッケージマネージャ**: npm

## コマンド

| コマンド | 用途 |
|---------|------|
| `npm run dev` | 開発サーバー起動 (localhost:4321) |
| `npm run build` | プロダクションビルド |
| `npm run preview` | ビルドプレビュー |
| `npm run astro check` | 型チェック |

## ディレクトリ構造

| パス | 役割 |
|-----|------|
| `src/pages/` | ファイルベースルーティング |
| `src/layouts/` | レイアウトコンポーネント |
| `src/components/` | UIコンポーネント（.astro / React / Vue） |
| `src/content/` | Content Collections（MDX / Markdown） |
| `public/` | 静的ファイル |

## コーディング規約

- デフォルトは静的生成（SSG）。SSRは必要な場合のみ有効化
- コンポーネントは .astro を優先、インタラクティブ部分のみ React/Vue
- Content Collectionsでコンテンツを型安全に管理
- 画像は `astro:assets` の `<Image>` コンポーネントで最適化
- アイランドアーキテクチャを活用し、JS配信量を最小化

## Git規約

- ブランチ: `feature/`, `fix/`, `content/`
- コミットメッセージ: Conventional Commits形式