skills/hukusuke1007/agent-skills/nextjs-better-auth-postgres-docker

nextjs-better-auth-postgres-docker

SKILL.md

Next.js + Better Auth + PostgreSQL

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
Weekly Installs
1
GitHub Stars
2
First Seen
2 days ago
Installed on
amp1
cline1
opencode1
cursor1
kimi-cli1
codex1