Learning Paths

Use this page to choose the shortest route through the documentation. Confii is broad; most users do not need every feature on day one.

I Want Typed YAML Config

1. Quick Start
2. Configuration
3. Accessing Values
4. Validation

Outcome: a Config[T] that loads local files and returns a typed model.

I Want Environment-Specific Config

1. Mental Model
2. Environment Resolution
3. Merging
4. CLI plan command

Outcome: config/default.yaml plus selected environment overrides, with clear precedence and inspection.

I Want Secrets

1. Secrets
2. Configuration
3. Troubleshooting
4. Production Checklist

Outcome: eager secret resolution with explicit providers, redaction, and startup failure for missing required secrets.

I Want Cloud Configuration

1. Installation
2. Sources
3. Secrets
4. Examples

Outcome: opt-in cloud modules and build tags with S3, SSM, Vault/OpenBao, or cloud secret stores.

I Am Migrating From Another Config Library

1. Mental Model
2. Configuration
3. Sources
4. Environment Resolution
5. Migrate to v2

Outcome: a gradual move from ad hoc loaders to a self-configured Confii project.

I Am Building a Production Service

1. Quick Start
2. Production Checklist
3. Context & Cancellation
4. Validation
5. Secrets
6. Introspection
7. CLI

Outcome: bounded startup, validation before publication, explicit secret routing, diagnostics, and deployment preflight commands.

I Need to Customize Confii

1. Extensibility
2. Sources
3. Secrets
4. Hooks
5. Validation
6. Architecture

Outcome: custom loaders, stores, validators, hooks, exporters, and provider registrations that still participate in Confii's transaction model.

I Am Debugging a Broken Setup

1. Troubleshooting
2. CLI
3. Introspection
4. Errors

Outcome: inspect source order, explain values, classify errors, and avoid guessing which source won.