検証コマンド一覧
Pull Requestを出す前に実行するコマンドです。
検証コマンド
bash
npm test
npm run build
npx tsc --noEmit
npm run lint| コマンド | 内容 | 備考 |
|---|---|---|
npm test | Vitestで単体テストと統合テストを実行 | 統合テストはローカルSupabaseの起動が必要 |
npm run build | Next.jsの本番ビルド | 型チェックの前に実行する |
npx tsc --noEmit | TypeScriptの型チェック | ビルドが生成する型に依存する |
npm run lint | ESLint |
実行順
npx tsc --noEmit はNext.jsがビルド時に生成する型（LayoutProps など）に依存します。クローン直後は npm run build を先に実行してください。
開発サーバー
bash
npm run dev -- --port 3000既存の開発サーバーがある場合、同じポートに新しいプロセスを重ねて起動しないでください。
テストの絞り込み
bash
# 単体テストのみ（Supabase不要）
npx vitest run tests/unit
# 統合テストのみ（Supabaseの起動が必要）
npx vitest run tests/integration
# 名前で絞り込む
npx vitest run -t "transition"テストの対象は tests/**/*.test.ts です。
| 置き場所 | 対象 | ローカルSupabase |
|---|---|---|
tests/unit/ | Server Action、ドメイン、認可ガード | 不要 |
tests/integration/ | Supabaseへ接続するRepository | 必要 |
tests/support/ | 統合テスト用のDB初期化・補助コード | — |
ローカルSupabase
bash
npx supabase start # 起動（初回はイメージ取得で時間がかかる）
npx supabase status # 接続情報の確認
npx supabase db reset # スキーマをmigrationから再適用（データは消える）
npx supabase stop # 停止出力の扱い
supabase start と supabase status の出力には SERVICE_ROLE_KEY が含まれます。実行結果をそのままIssueやチャットへ貼らないでください。
Supabase Studio は http://127.0.0.1:54323 で開けます。
ドキュメントサイト
このサイト自体の確認に使います。
bash
npm run docs:dev # ローカルで確認
npm run docs:build # 静的ビルド（リンク切れがあると失敗する）
npm run docs:preview # ビルド結果を確認