Configuration

Starter config

version = 1

[discovery]
extendExclude = []
useDefaultExcludes = true
respectGitIgnore = true
forceExclude = false
followSymlinks = false

[parsing.json]
mode = "auto"

[schemas]
maxDepth = 8
concurrency = 8
requireCoverage = false

[schemas.optimizations]
enabled = true

[schemas.optimizations.azure]
pruneResources = true

[schemas.fetch]
enabled = true
cache = true
timeout = "10s"
retries = 2
retryMinWait = "250ms"
retryMaxWait = "2s"
allowedDomains = []
blockedDomains = []

[schemas.compile]
timeout = "30s"

[schemas.catalogs]
enabled = true
failure = "warn"

[[schemas.catalogs.sources]]
name = "schemastore"
format = "schemastore"
url = "https://www.schemastore.org/api/json/catalog.json"
enabled = true

[[schemas.associations]]
file = "settings/*.toml"
schema = "./schemas/settings.schema.json"

[output]
showSkipped = false
verbose = false
quiet = false
locations = false
branchErrors = "best"

[[ignore]]
file = "fixtures/*.json"
keyword = "required"
property = "legacyName"
reason = "legacy fixture kept for compatibility"

Format and output file are per-run choices — use --format and --output on dollarlint validate whenever you need JSON, SARIF, or a file artifact.

Discovery

Leave include unset to use the built-in JSON, JSONC, JSON5, JSON Lines, YAML, YML, and TOML discovery defaults. Set it only when you want to replace that default set with custom discovery globs.

Discovery, exclude, association, and ignore-file globs are matched against slash-separated paths relative to the validation root. A glob without a slash matches basenames at any depth, so *.json matches both package.json and config/settings.json. Use slashes when you want to match a particular relative path shape.

Default excludes are intentionally not written out by dollarlint init. Keep project-specific ignores in extendExclude.

Parsing

JSON parsing defaults to auto: ordinary .json files stay strict, while known JSONC-by-convention files such as tsconfig*.json, jsconfig*.json, .vscode/settings.json, and devcontainer.json allow comments and trailing commas. Files ending in .jsonc always use JSONC parsing.

Schemas

Associations

Associations map discovered files to schemas when the file does not declare one itself. DollarLint also has a built-in association for .dollarlint.toml, backed by the embedded config schema; explicit in-file declarations and user associations still win.

[[schemas.associations]]
file = "settings/*.toml"
schema = "./schemas/settings.schema.json"

Association globs are matched against paths relative to the validation root and use the same basename-any-depth behavior as discovery globs. In-file declarations win over associations.

Fetch and compile

Optimizations

Optimizations reduce expensive schema work without changing validation semantics. They are enabled by default and can be turned off globally or one optimization at a time when you need to debug schema behavior exactly as fetched.

Catalogs

Catalogs map well-known filenames to schemas when a file doesn't declare $schema and no explicit or built-in association matches. SchemaStore is the built-in catalog source, and custom sources can use the same catalog shape. Explicit in-file schemas still report schema load or compile failures as issues; the catalog failure policy only applies to catalog loading and catalog-inferred schemas.

Ignore rules

[[ignore]]
file = "fixtures/*.json"
keyword = "required"
property = "legacyName"
reason = "legacy fixture kept for compatibility"

Ignore rules match validation issues by file glob, JSON Schema keyword, and property. All configured fields must match; omitted fields act like wildcards. Ignored issues are still reported as ignored and do not make the run fail.

Output preferences

Config can set issue-reporting and text-output preferences. Machine-readable formats and output files are intentionally per-run choices.