XRAPH/Work/Configuration
Go · since 2026

Confy

Config loading that stays out of the way: files, environment variables, Consul and Kubernetes ConfigMaps, typed getters with defaults, struct binding with a `default` tag, and hot reload on file change. Auto-discovery walks up from a nested service directory until it finds the repo’s config, which matters in a monorepo.

Language
Go
Category
Configuration
Since
2026
Stars
0
Repository
01

Anatomy

4 modules
01

Sources

Files, environment and remote providers, layered in a declared order.

02

Binding

Struct binding with typed getters and defaults.

03

Hot reload

Watchers that re-bind without a restart.

04

Discovery

Finds configuration in a monorepo without being told where.

02

Why it exists

Design notes

#What it is

A configuration library for Go that sits between the ones that do too little and the ones that do too much. No global state and no surprises at import time, just a struct you own.

#What it does

  • Multiple sources: files, environment variables, Consul, Kubernetes ConfigMaps, composed in priority order.
  • Typed getters with defaults: GetInt, GetBool, GetDuration, so a missing key is a default rather than a zero value you have to notice.
  • Struct binding with a default tag for keys absent from the config.
  • Hot reload through file watching.
  • Auto-discovery: searches the current directory and its parents for config.yaml and config.local.yaml.

#The monorepo detail

Auto-discovery sounds like a convenience until you have a monorepo where every service lives three directories deep and go run ./cmd/whatever resolves relative paths from wherever you happened to be standing. Walking up the tree removes an entire genre of "works on my machine".

03

Signals

GitHub
Stars
0
Language
Go
Since
2026
Adopters
00

Shipping something on Confy? Nobody is listed here yet. Tell me what you built and you will be the first.

Get listed
04

Where it sits

Fields · papers