# pureconfig/pureconfig

A boilerplate-free library for loading configuration files

Repository: https://github.com/pureconfig/pureconfig
Canonical: https://ross.abutalabs.com/products/pureconfig
Homepage: https://pureconfig.github.io
Language: Scala
License: MPL-2.0
License Family: copyleft
Topics: pureconfig, scala-library, configuration, shapeless, scala, hacktoberfest
Last push: 2026-08-23T22:19:01+00:00

## Health v2 (maintenance only)
Score: 77/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 35, longevity 100
- inputs: {"age_days": 4022, "days_push": 10, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1540, forks 181 (observed 2026-08-28T04:05:00.482943+00:00)

## What it is
PureConfig is a Scala library that loads configuration files (HOCON, Java .properties, or JSON via Typesafe Config) into native Scala classes without boilerplate. It derives the deserialization code at compile time, supporting case classes, sealed traits, collections, and optional values out of the box.

## Use cases
- load HOCON config into case classes in Scala
- deserialize Typesafe Config to sealed traits
- avoid writing boilerplate config parsing code
- load JSON or .properties files into typed Scala objects
- add custom type support for configuration loading
- validate configuration structure at compile time

## When to choose
- you write Scala and use Typesafe Config/HOCON
- you want type-safe, boilerplate-free config loading into case classes
- you need extensible mapping for custom config types

## When to avoid
- your project is not on the JVM/Scala
- you need dynamic, schema-less access to configuration
- you use a different config format like YAML or TOML without conversion

## Facets
- artifact type: library
- maturity: stable
- function: configuration-management, serialization
- domain: developer-tools, backend, programming-languages
- platform: jvm
- tags: scala, hocon, typesafe-config, case-classes, boilerplate-free, config-loading

## Member repositories
- pureconfig/pureconfig (main) score 77

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:00.482943+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:30:51.919414+00:00, confidence not recorded.
  - readme: https://github.com/pureconfig/pureconfig (fetched 2026-08-28T04:05:00.482943+00:00, sha a85e3dc80590)
  - homepage: https://pureconfig.github.io (fetched 2026-08-29T11:32:17.328807+00:00, sha 229b2dc8b662)
- Data as of 2026-08-30T08:39:29.467469+00:00.