Framework Guides

How it works

Wrap your dev and build scripts with vars run:

{
  "scripts": {
    "dev": "vars run --env dev -- next dev",
    "build": "vars run --env prod -- next build"
  }
}

vars run decrypts your config, validates schemas, and injects variables into process.env before your framework starts.

Server vs Client

Server-side (API routes, SSR, Node.js): process.env works directly. Import vars from #vars for type safety.

Client-side (browser bundles): Frameworks don't pass process.env to the browser. You have two options:

1. Static generation - bake values into the generated file at build time:

   VARS_KEY=$KEY vars gen config.vars --platform static --env dev

2. Framework bridge - use your framework's native env passthrough (details in each guide below)

Choose your framework