For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ja/docs/modules/config.md (or send Accept: text/markdown).

環境と設定

ワークスペース全体で一つの検証済みスキーマ。

このガイドについて質問

構成を 1 つ変更して確認します

Web アプリを実行することから始めます。エディタで apps/web/.env.local を開きます。存在しない場合は、Web チュートリアルを使用して .env.example をそこにコピーします。無害な最初のチェックとして、EMAIL_PROVIDER=local を見つけてローカルに残します。この設定では、製品メールが実際の受信トレイではなくローカルプレビューに送信されます。 KEY=value 行を端末に貼り付けないでください。

有効にするサービスごとに、そのプロバイダーのセットアップガイドに従い、名前付きの値のみを置き換えてファイルを保存し、Ctrl + C で Web サーバーを停止し、以下のコマンドで再起動します。検証で欠落しているキーが指定された場合は、このファイルを再度開き、そのキーをプロバイダーガイドと比較します。データベースの移行で使用される値についてのみ、root .env の同期を維持します。これをコピーするだけでは、Next.js は構成されません。

corepack pnpm --filter @supastack/web dev

環境サンプルから始める

ルートの .env.example が設定の目録です。共有バリデーションは packages/config にあります。選択したアプリ環境とプロバイダーモードを一緒に確認してください。ローカルインターフェースは本番認証情報戦略ではありません。

認証情報なしの参照モードは local/test アプリ設定と fake/ローカルプロバイダーを要求します。本番プロバイダーを選ぶとランタイム要件が変わります。

秘密を API の背後に保つ

認証シークレット、データベース認証情報、プロバイダーキー、Stripe シークレット、Trigger 認証情報はサーバー専用です。NEXT_PUBLIC_ や EXPO_PUBLIC_ のプレフィックスを付けないでください。インストール中に表示したりエラーレスポンスに含めたりしないでください。

ブラウザは公開設定と許可されたモデルエイリアスを受け取ります。ワークスペース所有権、権限の決定、予算、プロバイダー選択はサーバー側で強制されたままです。

使う前に変更を検証する

既存の config パッケージを通じて設定を検証し、関連する決定的テストを実行します。実際の統合を検証する準備ができたら、別のオプトインプロバイダースモーク経路を使います。

corepack pnpm test
corepack pnpm check
corepack pnpm build

インストールとセットアップ

packages/config が process.env をパースする唯一の場所です: zod スキーマが型付きの ServerConfig と PublicConfig を生成し、プロバイダー選択は kinds として表現されます — providers.ai、providers.billing、providers.email、providers.jobs、providers.storage はそれぞれ名前付きアダプターと必須フィールドに解決されます。

プロバイダーを有効にするとその認証情報が必須になります: ソーシャルサインイン、s3 ストレージ kind、resend メール kind を有効にすると、不足変数の名前を挙げて起動が失敗します — 後のランタイムの驚きではなく。

STORAGE_PROVIDER=s3
STORAGE_BUCKET=kit
STORAGE_ENDPOINT=https://s3.example
STORAGE_PUBLIC_BASE_URL=https://cdn.example
# → config rejects the env if a required field is missing

実装ワークフロー

設定はサーバー境界で parseServerConfig 経由で読み、型付きの値を内側に渡します — 機能コード内で process.env に触れないでください。公開設定は別の、意図的に小さなオブジェクトで、クライアントへ安全にシリアライズできます。

プロダクト固有の env は消費側プロダクト自身のスキーマに属します。一つのプロダクトのためにキットのスキーマを肥大化させないでください。

検証とトラブルシューティング

スキーマ変更後は config パッケージのテストを実行し、不足している必須変数がエラー内で自分自身を名指しすることを確認します。ローカルではパースできるが本番で失敗する env は、たいてい文書化されていない必須フィールドを意味します。