environment-variables（环境变量）

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

1. 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