t3-oss/t3-env
T3 Env
t3-env is a type-safe environment manager and schema validator for TypeScript. It maps environment variables to static types to provide autocompletion and prevents configuration errors through a system that verifies required variables are present and correctly formatted before an application starts.
The project enforces strict variable scope to isolate server-side secrets from the client browser, preventing sensitive data from leaking into client-side bundles. It also provides configuration presets tailored to the naming conventions of specific hosting and deployment platforms.
The library integrates with schema validation libraries to ensure runtime integrity and uses a type-safe proxy interface to wrap environment objects. These mechanisms combine compile-time error detection with runtime validation to prevent deployment failures.
Features
- Type-Safe Configuration Managers - Provides a specialized manager for parsing and validating environment settings into structured, type-checked objects.
- Client-side Environment Variables - Manages the secure exposure of specific environment variables to client-side bundles while isolating secrets.
- Server-Side Secret Guarding - Blocks server-side variables from reaching the client and triggers errors if accessed in a browser context.
- Environment Variable Validation - Validates that required environment variables are present and correctly formatted before the application starts.
- Environment Variable Mapping - Binds environment variables to specific TypeScript types to catch configuration errors during compilation.
- Static Type Checking - Provides type checking for environment variables during development to ensure runtime stability and developer productivity.
- Client-Server Isolation - Enforces strict boundaries to ensure sensitive server-side secrets are never leaked into client-side bundles.
- Environment Variable Security - Isolates and protects sensitive configuration data by restricting access to server-side contexts.
- Secret Leak Prevention - Prevents sensitive credentials from leaking into the browser by isolating server-side secrets.
- Runtime Value Validation - Implements a runtime wrapper that validates environment variables against a schema before they are accessed by the application.
- Environment Variable Validation - Provides a utility to verify that environment variables match a defined schema before application startup.
- Schema-Driven Type Inference - Automatically derives TypeScript static type definitions from runtime validation schemas for environment variables.
- Schema Validation Libraries - Integrates with various schema validation libraries to ensure the structural integrity of environment data.
- Deployment Environment Management - Manages configuration settings across different deployment environments using structured presets.
- Typed Proxies - Provides a type-safe proxy that wraps the global environment object to enforce strict typing on access.
