environment-variables

環境変数

プロジェクトに環境変数を追加する方法は次のとおりです。

1. .env.example に追加します。

   NEW_VARIABLE=value_example
   

2. apps/web/env.ts に追加します。

   // サーバー専用変数の場合
   server: {
     NEW_VARIABLE: z.string(),
   }
   // クライアント側の変数の場合
   client: {
     NEXT_PUBLIC_NEW_VARIABLE: z.string(),
   }
   experimental__runtimeEnv: {
     NEXT_PUBLIC_NEW_VARIABLE: process.env.NEXT_PUBLIC_NEW_VARIABLE,
   }
   

3. クライアント側の変数の場合：

   • NEXT_PUBLIC_ を接頭辞として付ける必要があります
   • client セクションと experimental__runtimeEnv セクションの両方に追加します

4. turbo.json の globalDependencies の下に追加します。

   {
     "tasks": {
       "build": {
         "env": [
           "NEW_VARIABLE"
         ]
       }
     }
   }
   

例：

• input: |

  サーバー側の API キーを追加する

  .env.example

  API_KEY=your_api_key_here

  env.ts

  server: { API_KEY: z.string(), }

  turbo.json

  "build": { "env": ["API_KEY"] } output: "サーバー側の環境変数が正しく追加されました"

• input: |

  クライアント側の機能フラグを追加する

  .env.example

  NEXT_PUBLIC_FEATURE_ENABLED=false

  env.ts

  client: { NEXT_PUBLIC_FEATURE_ENABLED: z.coerce.boolean().default(false), }, experimental__runtimeEnv: { NEXT_PUBLIC_FEATURE_ENABLED: process.env.NEXT_PUBLIC_FEATURE_ENABLED, }

  turbo.json

  "build": { "env": ["NEXT_PUBLIC_FEATURE_ENABLED"] } output: "クライアント側の環境変数が正しく追加されました"

参照：

• apps/web/env.ts
• apps/web/.env.example
• turbo.json