Use-case recommendation

Best Format for Configuration Files in Repositories

TOML is a reliable default for strict, human-readable app configuration.

Recommendation

Recommendation

TOML

TOML is predictable and avoids common parser ambiguity pitfalls.

application/octet-stream

YAML

Use YAML for complex nested human-authored config documents.

Files: 10

INI

Use INI for legacy parser compatibility.

Files: 9

Related decisions

Related Decisions

FAQ

FAQ

What is the default format recommendation for this use case?

TOML is the recommended default format here.

How should teams validate this recommendation?

Use sample files and manifest endpoints to test compatibility and behavior before rollout.