テンプレート一覧に戻る

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の適切な分離

関連ガイド

検索

ガイドやテンプレートを検索...