nextjs-better-auth-postgres-docker

name	nextjs-better-auth-postgres-docker
description	Next.js + Better Auth + PostgreSQL を Docker で構築し、Cloud Run へデプロイするスキル。ローカル開発環境のセットアップから Docker Compose、Dockerfile 作成、Cloud Run + Cloud SQL + Secret Manager を使った本番デプロイまでをカバーする。「Next.js と Better Auth でアプリを作りたい」「Docker で PostgreSQL を使いたい」「Docker で構築したい」「Docker Compose を使いたい」「アプリを Docker 化したい」「Dockerfile を書きたい」「Cloud Run にデプロイしたい」「Cloud SQL や Secret Manager を使いたい」ときに使う。
license	MIT
metadata	{"author":"shohei","version":"1.0.0"}

Next.js + Better Auth + PostgreSQL + Docker

Next.js App Router + Better Auth + PostgreSQL を Docker で構築し、Cloud Run へデプロイするためのスキルです。

対象スタック

• フレームワーク: Next.js (App Router, TypeScript)
• 認証: Better Auth
• DB: PostgreSQL 16
• パッケージマネージャ: pnpm
• インフラ: Docker / Docker Compose、Google Cloud Run、Cloud SQL、Secret Manager

参照ドキュメント

詳細な手順は以下の reference ファイルに分けています。

ファイル	内容
references/local-setup.md	ローカル開発環境の構築（Docker Compose + アプリ Docker 化まで）
references/cloud-run-deploy.md	Cloud Run へのデプロイ（Cloud SQL + Secret Manager 使用）

どちらを参照するか

• ローカル環境を構築したい → references/local-setup.md を読む
• Cloud Run にデプロイしたい → references/cloud-run-deploy.md を読む
• 両方やりたい → local-setup.md を完了してから cloud-run-deploy.md に進む

環境変数の切り替えまとめ

実行環境によって値が変わる変数を把握しておく。

変数名	ローカル直実行	Docker Compose (app コンテナ)	Cloud Run
DATABASE_URL のホスト	localhost	db	Cloud SQL Unix socket
BETTER_AUTH_URL	http://localhost:3000	http://localhost:3000	Cloud Run サービス URL
INTERNAL_API_BASE_URL	http://localhost:3000	http://app:3000	Cloud Run サービス URL