Static/dynamic config controls (wip)

[theoephraim]

Feasibility spike on bringing back static/dynamic control. This was brought about by sveltekit's improved env tooling. We would like to be able to confidently say that users shoudl use varlock, but need to handle the static vs dynamic control better.

---

Summary

• add first-class static/dynamic config semantics in env graph + runtime metadata
• add runtime helpers for dynamic+public values (getPublicDynamicEnv, loadPublicDynamicEnv)
• wire dynamic+public behavior through Vite/Astro/Next integrations
• make Next dynamic key access mark routes dynamic (including nested component access)
• add/expand framework tests (Next, Astro, SvelteKit)
• update integration docs and add a new static-vs-dynamic guide

Validation

• bun run lint:fix
• REPACK=1 bunx vitest run framework-tests/frameworks/nextjs/nextjs-v16.test.ts -t "dynamic public access in page marks route dynamic"
• bun run --filter @varlock/website build
• pre-push hook typecheck + bumpy checks passed

[github-actions]

The changes in this PR will be included in the next version bump.

Minor releases

• @varlock/astro-integration 1.0.4 → 1.1.0
• @varlock/cloudflare-integration 1.1.5 → 1.2.0 (cascade)
• @varlock/expo-integration 1.1.1 → 1.2.0
• @varlock/nextjs-integration 1.1.3 → 1.2.0
• @varlock/vite-integration 1.1.3 → 1.2.0
• varlock 1.5.1 → 1.6.0

Bump files in this PR

• static-dynamic-config.md (view diff) (edit)

Click here if you want to add another bump file to this PR

---

This comment is maintained by bumpy.

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	npm/​@​types/​react@​19.2.15

View full report

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	varlock-website	239c7f8	Commit Preview URL Branch Preview URL	Jun 06 2026, 07:17 AM

[pkg-pr-new]

Open in StackBlitz

varlock

npm i https://pkg.pr.new/varlock@750

@varlock/astro-integration

npm i https://pkg.pr.new/@varlock/astro-integration@750

@varlock/expo-integration

npm i https://pkg.pr.new/@varlock/expo-integration@750

@varlock/nextjs-integration

npm i https://pkg.pr.new/@varlock/nextjs-integration@750

@varlock/vite-integration

npm i https://pkg.pr.new/@varlock/vite-integration@750

commit: 239c7f8