Environment Variables

This is how we add environment variables to the project:

1. Add to .env.example:

   NEW_VARIABLE=value_example

2. Add to apps/web/env.ts:

   // For server-only variables
   server: {
     NEW_VARIABLE: z.string(),
   }
   // For client-side variables
   client: {
     NEXT_PUBLIC_NEW_VARIABLE: z.string(),
   }
   experimental__runtimeEnv: {
     NEXT_PUBLIC_NEW_VARIABLE: process.env.NEXT_PUBLIC_NEW_VARIABLE,
   }

3. For client-side variables:

   • Must be prefixed with NEXT_PUBLIC_
   • Add to both client and experimental__runtimeEnv sections

4. Add to turbo.json under globalDependencies:

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

examples:

• input: |

  Adding a server-side API key

  .env.example

  API_KEY=your_api_key_here

  env.ts

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

  turbo.json

  "build": {
  "env": ["API_KEY"]
  }
  output: "Server-side environment variable properly added"

• input: |

  Adding a client-side feature flag

  .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: "Client-side environment variable properly added"

references:

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