Configuration

Standards for application configuration using environment variables and libraries.

mte90 141d10d 2 files · 1.5 KB Updated

File contents

Golang Configuration Standards

Priority: P1 (STANDARD)

Principles

  • 12-Factor App: Store config in environment variables.
  • Typed Config: Load config into a struct, validate it immediately.
  • Secrets: Never commit secrets. Use env vars or secret managers.
  • No Globals: Return a Config struct and inject it.

Libraries

  • Standard Lib: os.Getenv for simple apps.
  • Viper: Industry standard for complex configs (supports env, config files, remote config).
  • Koanf: Lighter, cleaner alternative to Viper.
  • Caarlos0/env: Good for strict struct tagging.

Pattern

  1. Define Config struct.
  2. Load from defaults.
  3. Override from file (optional).
  4. Override from Env (priority).
  5. Validate.

References

  • Config Pattern

mte90/dotfiles/tree/main/.config/opencode/skills/golang/configuration commit 141d10dbcd

Frequently asked questions

npx skillmds@latest add mte90/configuration