テンプレート一覧に戻る

Node.js + Express + TypeScript

Express 5 + TypeScript + Prisma のバックエンドAPI向けCLAUDE.md。シンプルで拡張しやすいAPIサーバー構築に最適です。

初級nodejsexpresstypescript
CLAUDE.md
# プロジェクト名

Express 5 + TypeScript で構築されたREST APIサーバー。

## 技術スタック

- **フレームワーク**: Express 5.x
- **言語**: TypeScript 5.x (strict mode)
- **ORM**: Prisma 6.x
- **バリデーション**: Zod
- **テスト**: Vitest + Supertest
- **パッケージマネージャ**: npm

## コマンド

| コマンド | 用途 |
|---------|------|
| `npm run dev` | 開発サーバー起動 (tsx --watch) |
| `npm run build` | TypeScriptビルド |
| `npm start` | プロダクション起動 |
| `npm test` | Vitest実行 |
| `npm run lint` | ESLint実行 |
| `npx prisma migrate dev` | マイグレーション適用 |

## ディレクトリ構造

| パス | 役割 |
|-----|------|
| `src/routes/` | ルート定義 |
| `src/controllers/` | コントローラー |
| `src/services/` | ビジネスロジック |
| `src/middleware/` | ミドルウェア |
| `src/types/` | TypeScript型定義 |
| `prisma/` | Prismaスキーマ・マイグレーション |

## コーディング規約

- Controller → Service → Repository のレイヤー構成
- リクエスト/レスポンスの型はZodスキーマで定義・バリデーション
- エラーはカスタムエラークラスで統一し、エラーハンドリングミドルウェアで処理
- 環境変数は dotenv + Zodバリデーションで管理
- async/awaitを使用、コールバックは使わない

## Git規約

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

関連ガイド

検索

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