Skip to content

Document config-shaping env vars delivered via loadEnv .env files#564

Draft
kylebernhardy wants to merge 2 commits into
mainfrom
docs/load-env-config-shaping-1513
Draft

Document config-shaping env vars delivered via loadEnv .env files#564
kylebernhardy wants to merge 2 commits into
mainfrom
docs/load-env-config-shaping-1513

Conversation

@kylebernhardy

Copy link
Copy Markdown
Member

Companion docs for HarperFast/harper#1580 (fixes HarperFast/harper#1513): HARPER_CONFIG / HARPER_SET_CONFIG / HARPER_DEFAULT_CONFIG delivered via a component's loadEnv .env file are now applied before the root config is composed, making .env delivery equivalent to a real process env var.

Adds a Config-Shaping Variables section to the environment-variables reference: behavior, precedence (process env wins unless override: true), and the limitations (encrypted values can't shape config; componentsRoot can't be redirected via .env; only the three vars are applied early).

Note for review

Version-gated <VersionBadge type="changed" version="v5.2.0" /> on the assumption the core PR ships in the next minor from main. Hold merging until harper#1580 lands and confirm the version then.

Generated by an LLM (Claude Fable 5).

Companion to HarperFast/harper#1580 (fixes HarperFast/harper#1513):
HARPER_CONFIG / HARPER_SET_CONFIG / HARPER_DEFAULT_CONFIG delivered via
a component .env are now applied before config composition. Documents
precedence, encrypted-value and componentsRoot limitations.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request adds a new section to the environment variables documentation explaining how config-shaping variables are loaded early from .env files starting in version 5.2.0. The review feedback suggests a minor clarification to specify that the override: true property belongs to the loadEnv configuration rather than a generic component.

Comment thread reference/environment-variables/overview.md Outdated
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Jul 2, 2026

Copy link
Copy Markdown

🚀 Preview Deployment

Your preview deployment is ready!

🔗 Preview URL: https://preview.harper-documentation.harperfabric.com/pr-564

This preview will update automatically when you push new commits.

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.

MCP application config from loadEnv (.env) not applied — config composed/memoized before components run

2 participants