Skip to content

docs: document environment loading precedence - #172

Open
shuaiyafei wants to merge 1 commit into
StreamGive:mainfrom
shuaiyafei:docs/env-precedence
Open

shuaiyafei wants to merge 1 commit into
StreamGive:mainfrom
shuaiyafei:docs/env-precedence

Conversation

@shuaiyafei

Copy link
Copy Markdown

Summary

  • Document how local, test, Docker Compose, and GitHub Actions environments load variables.
  • Explain precedence between shell/CI variables and dotenv files.
  • Document module-load timing so contributors know environment changes require a process restart.

Validation

  • npm run typecheck passed.
  • git diff --check passed.
  • npm run lint is blocked by a pre-existing invalid character in test/routes/ngos.test.ts:241.
  • npm run format reports pre-existing formatting issues across the repository and cannot parse the same test file.
  • npm test is blocked by the same parse error and unavailable local Postgres (ECONNREFUSED).

Closes #164

Explain how local, test, Docker Compose, and CI environments load values and which settings take precedence.
@shuaiyafei
shuaiyafei force-pushed the docs/env-precedence branch from fbb2a57 to 0c9c8fc Compare October 7, 2026 02:03

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document environment loading precedence

1 participant