テンプレート一覧に戻る
Next.js + TypeScript
Next.js 15 App Router + TypeScript + Tailwind CSS のプロジェクト向けCLAUDE.md。shadcn/uiを使ったモダンなWeb開発に最適です。
中級nextjstypescripttailwindreactshadcn
CLAUDE.md
# プロジェクト名
Next.js 15 + TypeScript で構築されたWebアプリケーション。
## 技術スタック
- **フレームワーク**: Next.js 15 (App Router)
- **言語**: TypeScript 5.x (strict mode)
- **スタイリング**: Tailwind CSS v4 + shadcn/ui
- **状態管理**: React Server Components + React Query
- **テスト**: Vitest + Playwright
- **パッケージマネージャ**: npm
## コマンド
| コマンド | 用途 |
|---------|------|
| `npm run dev` | 開発サーバー起動 (localhost:3000) |
| `npm run build` | プロダクションビルド |
| `npm run lint` | ESLint実行 |
| `npm test` | Vitest実行 |
| `npm run e2e` | Playwright E2Eテスト |
## ディレクトリ構造
| パス | 役割 |
|-----|------|
| `src/app/` | App Routerのページ・レイアウト |
| `src/components/` | UIコンポーネント(shadcn/ui含む) |
| `src/lib/` | ユーティリティ・ヘルパー |
| `src/types/` | TypeScript型定義 |
| `public/` | 静的ファイル |
## コーディング規約
- コンポーネントは関数コンポーネント + hooks
- Props型は `interface` で定義(`type` より優先)
- ファイル名はkebab-case、コンポーネント名はPascalCase
- `"use client"` は必要な場合のみ付与
- Server Actionsでフォーム処理を実装
- エラーハンドリングは error.tsx で統一
## Git規約
- ブランチ: `feature/`, `fix/`, `chore/`
- コミットメッセージ: Conventional Commits形式
- PRは1機能1PR、レビュー必須.claude/rules/project-rules.md
# コードレビュー基準
## 必須チェック項目
- TypeScriptの型安全性(any禁止)
- アクセシビリティ(aria属性、セマンティックHTML)
- パフォーマンス(不要な再レンダリングの防止)
- Server/Client Componentの適切な分離