Next.js + MySQL + Docker Starter

このプロジェクトは、Next.js, MySQL, Prisma, Docker, pnpm を使用したフルスタック開発テンプレートです。

構成

• Frontend/Backend: Next.js (App Router, Server Actions)
• Database: MySQL 8.0
• ORM: Prisma
• Testing: Playwright
• Formatting: Prettier

開発の始め方

1. 準備

リポジトリをクローンした後、環境変数ファイルを作成します。

copy .env.example .env

署名付きクッキーでゲームセッションを管理するため、.env の GAME_SESSION_SECRET を必ず設定してください。 本番環境では未設定だとアプリが起動しません。

openssl rand -base64 32

2. コンテナの起動

Docker を使用して、アプリケーションとデータベースを起動します。

docker compose up

初回起動時には pnpm install が自動的に実行されます。 http://localhost:3000 にアクセスして、Next.js の画面が表示されることを確認してください。

3. データベースのセットアップ

新しいモデルを定義したり、クローン直後の場合はマイグレーションを実行してテーブルを作成します。

docker compose exec app npx prisma db push

4. 便利コマンド

• コンテナの停止: docker compose down
• テストの実行: docker compose exec app npx playwright test
• Prisma Studio (GUIでDB確認): docker compose exec app npx prisma studio

デプロイ

このプロジェクトは Vercel へのデプロイを想定しています。 next.config.ts で output: "standalone" が設定されているため、Docker イメージとしても軽量に動作します。