Build-Time vs Runtime Validation
When to validate env vars during build, at startup, and in CI.
1 min read
Blog
Release notes, changelogs, and announcements.
features
Reactive Environment Variables with watchEnv
Long-running processes can now react to environment variable changes at runtime — no restart required.
1 min read
Schema Composition for Library Authors
Publish reusable env schemas from your library so consumers can extend them.
1 min read
Using CtroEnv in Deno and Bun
CtroEnv detects Deno and Bun environments automatically — no configuration needed.
1 min read
Performance and Bundle Size
CtroEnv's zero-dependency core is 6.5 KB gzipped — here's how it stays lean.
1 min read
Using CtroEnv on Cloudflare Workers
Validate environment variables in Cloudflare Workers with workersSource.
1 min read
Error Handling Patterns with CtroEnv
Graceful degradation, per-environment handling, and custom error reporting.
1 min read
TypeScript Inference Tricks with CtroEnv
How CtroEnv infers exact types from validators without manual type definitions.
1 min read
Environment Variables in Next.js
Server/client split, build-time validation, and secret access with the CtroEnv Next.js adapter.
1 min read
Node.js Adapter Deep Dive
How loadEnv() parses .env files, handles interpolation, and integrates with process.env.
1 min read
Build-Time Env Validation with Vite
Catch misconfigured env vars during the Vite build with ctroenvPlugin.
1 min read
Chain Order: The #1 Gotcha in CtroEnv
Why string().secret().url() fails at runtime and how to avoid it.
1 min read
Building Custom Validators
Extend CtroEnv with your own validator factories using createValidator and applyChain.
1 min read
Proxy Traps Deep Dive
How CtroEnv's Proxy protects secret values from accidental exposure.
1 min read
CI/CD Patterns for Environment Validation
Catch missing env vars before they reach production with ctroenv check and validate.
1 min read
Debugging Environment Variable Errors
Understand every CtroEnv error message and how to fix it.
1 min read
Migrating from dotenv to CtroEnv
Replace scattered process.env access with a single typed schema.
1 min read
Testing Your Environment Variables with CtroEnv
Use objectSource() to test env validation without touching process.env.
1 min read
Composite Source Detection — Turbopack and Client-Side Compatibility
How detectSource() now prefers import.meta.env for dynamic NEXT_PUBLIC access in Next.js 16 Turbopack client bundles.
1 min read
Environment Variables in Monorepos
Schema composition for reusable env definitions across monorepo packages with extendSchema.
1 min read
Protecting Secrets at Runtime
Runtime secret masking prevents accidental leaks of JWT secrets, API keys, and database credentials.
1 min read
Turbopack Compat, Better Types, and Quality Improvements
Eager validation for Turbopack, const type parameter for pick(), and string | undefined for env.meta.get().
1 min read
v1.1.0 — Secret Masking & Schema Composition
Runtime secret masking, schema composition for monorepos, and universal AI agent guide.
1 min read
v1.1.1 — Bug Fixes & Quality Improvements
Fixes for env.meta, Next.js server-only key guard, CLI stderr, and boolean validator polish.
1 min read
v1.2.0 — JSON Config, Env File Parsing, CLI Improvements
Smarter env file parsing, JSON configuration support, and check --strict for value validation.
1 min read
Why CtroEnv?
Bring the same rigor from your type system to the environment variables your app depends on.
1 min read
v1.0.1 — Polish & Developer Experience
Error message refinement, performance benchmarks, and bundle size optimization.
1 min read
v1.0.0 — Type-Safe Environment Variables for TypeScript
Initial release of CtroEnv: define, validate, and infer types for environment variables with zero runtime dependencies.
1 min read