テンプレート一覧に戻る
HTMX + Alpine.js
HTMX + Alpine.js のプロジェクト向けCLAUDE.md。サーバーサイドレンダリングと最小限のJSでのインタラクティブUI開発に最適です。
初級htmxalpinessrminimal-js
CLAUDE.md
# プロジェクト名
HTMX + Alpine.js で構築されたサーバーサイドレンダリングWebアプリケーション。
## 技術スタック
- **フロントエンド**: HTMX 2.x + Alpine.js 3.x
- **テンプレート**: Jinja2 / Go templates / ERB
- **サーバー**: 任意のバックエンド(Python, Go, Ruby等)
- **スタイリング**: Tailwind CSS v4
## コマンド
| コマンド | 用途 |
|---------|------|
| サーバー起動 | バックエンドに依存 |
| ブラウザDevTools | HTMXリクエスト確認 |
| `npx tailwindcss -w` | Tailwind CSS watchモード |
## ディレクトリ構造
| パス | 役割 |
|-----|------|
| `templates/` | HTMLテンプレート |
| `templates/partials/` | HTMX部分テンプレート |
| `static/js/` | Alpine.jsコンポーネント |
| `static/css/` | スタイルシート |
## コーディング規約
- ページ遷移は `hx-boost` でSPA風にする
- 部分更新は `hx-get` / `hx-post` + `hx-target` + `hx-swap`
- Alpine.jsは `x-data` でクライアント側の状態管理
- サーバーはHTMLフラグメントを返す(JSONではなく)
- プログレッシブエンハンスメント: JSなしでも基本機能が動作すること
- CSSクラスの切り替えは `hx-indicator` でローディング表示
## Git規約
- ブランチ: `feature/`, `fix/`, `chore/`
- コミットメッセージ: Conventional Commits形式