confkit

Type‑safe config. Secure secrets. One import.

Confkit is a tiny runtime for defining, validating, and safely exposing configuration and secrets across Node, edge, serverless, Next.js, Vite, and Expo.

• End‑to‑end types from a single source of truth
• Multiple sources (env, files, cloud secret stores) with clear layering
• Runtime validation and deep redaction of secrets
• Explicit client exposure for public values
• Friendly CLI and framework plugins

Docs: https://docskit.dev

Install

pnpm add confkit
# optional
pnpm add @confkit/next @confkit/vite @confkit/expo @confkit/aws @confkit/gcp @confkit/azure @confkit/doppler @confkit/1password

60‑second Quick Start

import { defineConfig, s, source } from 'confkit';

export const config = defineConfig({
  sources: [source().env(), source().file('config.json')],
  schema: {
    NODE_ENV: s.enum(['development','test','production']).default('development'),
    PORT: s.port().default(3000),
    DATABASE_URL: s.url(),
    PUBLIC_APP_NAME: s.string().client().default('confkit'),
    STRIPE_SECRET: s.secret(s.string()),
  },
});

import { config } from './conf/config';
const env = await config.ready();
console.log('Listening on', env.PORT);

Framework Integrations

• Next.js: docs/integrations/next.mdx
• Vite: docs/integrations/vite.mdx
• Expo: docs/integrations/expo.mdx

CLI

npx confkit help
npx confkit check --file conf/config.ts --env production
npx confkit print --file conf/config.ts --json
npx confkit dev --file conf/config.ts
npx confkit init
npx confkit explain --key FOO
npx confkit doctor
npx confkit types --out confkit-env.d.ts

Community

• Discord: https://discord.gg/CR5Pm5h7T8

Contributing

PRs welcome! Please read CONTRIBUTING.md and CODE_OF_CONDUCT.md before opening a PR or issue:

• Contributing Guide: CONTRIBUTING.md
• Code of Conduct: CODE_OF_CONDUCT.md

Useful entry points:

• Core runtime: packages/confkit/src/index.ts
• Loader: packages/confkit/src/load.ts
• CLI: packages/confkit/src/cli/index.ts
• Next: packages/confkit-next/src
• Vite: packages/confkit-vite/src/index.ts

License

MIT