Skip to content

environment-variables.md

Latest commit

 

History

History
28 lines (19 loc) · 1.06 KB

environment-variables.md

File metadata and controls

28 lines (19 loc) · 1.06 KB

Environment Variables

Quick Rules

  • Public client env: NEXT_PUBLIC_* only, validated in common/src/env-schema.ts (used via @codebuff/common/env).
  • Server secrets: validated in packages/internal/src/env-schema.ts (used via @codebuff/internal/env).
  • Runtime/OS env: pass typed snapshots instead of reading process.env throughout the codebase.

Env DI Helpers

  • Base contracts: common/src/types/contracts/env.ts (BaseEnv, BaseCiEnv, ClientEnv, CiEnv)
  • Helpers: common/src/env-process.ts, common/src/env-ci.ts
  • Test helpers: common/src/testing-env-process.ts, common/src/testing-env-ci.ts
  • CLI: cli/src/utils/env.ts (getCliEnv)
  • CLI test helpers: cli/src/testing/env.ts (createTestCliEnv)
  • SDK: sdk/src/env.ts (getSdkEnv)
  • SDK test helpers: sdk/src/testing/env.ts (createTestSdkEnv)

Loading Order

Bun loads (highest precedence last):

  • .env.local (Infisical-synced secrets, gitignored)
  • .env.development.local (worktree overrides like ports, gitignored)

Releases

Release scripts read CODEBUFF_GITHUB_TOKEN.