# sindresorhus/conf

Simple config handling for your app or module

Repository: https://github.com/sindresorhus/conf
Canonical: https://ross.abutalabs.com/products/conf
Language: TypeScript
License: MIT
License Family: permissive
Topics: config, configuration-management, preferences, storage, json-schema, json, command-line, node-module, npm-package
Last push: 2026-07-21T15:56:22+00:00

## Health v2 (maintenance only)
Score: 78/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 93, release rhythm 45, longevity 100
- inputs: {"age_days": 3725, "days_push": 43, "days_rel": 210, "gap_med": 113, "n_releases_24m": 6}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1347, forks 139 (observed 2026-08-28T04:04:27.560238+00:00)

## What it is
A Node.js library for persisting app or module configuration as a JSON file, handling storage location and atomic writes automatically. It supports JSON Schema validation via AJV, dot-notation access, and defaults.

## Use cases
- persist user settings for a CLI tool
- store app preferences in a JSON file
- validate config values with a JSON schema
- save and load small key-value config data
- manage nested config options with dot notation

## When to choose
- you need simple, small-scale config persistence for a Node.js app or CLI
- you want schema-validated settings with defaults and atomic writes
- you're building an Electron app and want the underlying store behind electron-store

## When to avoid
- multiple processes need to write to the same config store concurrently
- you need to persist large datasets (use SQLite or a real database)
- you need a full database with queries or indexing

## Facets
- artifact type: library
- maturity: stable
- function: configuration-management, serialization
- domain: developer-tools, backend
- platform: cross-platform
- tags: config-storage, -schema-validation, user-preferences, dot-notation, atomic-writes, command-line, nodejs

## Member repositories
- sindresorhus/conf (main) score 78

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:27.560238+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:42:38.443648+00:00, confidence not recorded.
  - readme: https://github.com/sindresorhus/conf (fetched 2026-08-28T04:04:27.560238+00:00, sha 6d546523f130)
  - registry_npm: https://registry.npmjs.org/conf (fetched 2026-08-29T12:02:00.009451+00:00, sha 06e530d3b1b3)
- Data as of 2026-08-30T08:39:29.467469+00:00.