iso-conf

Simple config handling for your app or module with Standard Schema validation and extended JSON serialization

Features

• Fully typed via Standard Schema — works with Zod, Valibot, ArkType, and more
• Extended JSON types (URL, Map, Set, bigint, RegExp, Uint8Array)
• Atomic writes to disk
• Dot-notation access for nested properties
• Change hooks (onDidChange, onDidAnyChange)
• Defaults from schema

Install

pnpm install iso-conf
Copy

Usage

import { z } from 'zod/v4'
import { Conf } from 'iso-conf'

const schema = z.object({
  foo: z.number().min(1).max(100).default(50),
  bar: z.url().optional(),
})

const config = new Conf({ projectName: 'my-app', schema })

config.set('foo', 42)
console.log(config.get('foo'))
//=> 42
Copy

Any Standard Schema compliant library can be used for the schema option. Zod is shown above as an example only.

Docs

Check https://hugomrdias.github.io/iso-repo/modules/iso_conf.html

License

MIT © Hugo Dias