Configuration Reference

Every falcon.json key, its type, default, and accepted values — generated from the config schema. For task-oriented setup, see the Configuration guide.

$schema

$schemastring | null

URL of the falcon.json JSON Schema, enabling rule autocomplete and level validation in editors.

baseline

baselinestring | null

Diagnostic baseline path. Relative paths resolve from the configuration files root (the current directory for user-level config). The CLI --baseline path takes precedence. Omit or use null for no baseline.

error-on-warnings

error-on-warningsboolean

Fail checks on warnings as well as errors. By default, warning-only checks succeed. CLI --error-on-warnings enables this setting.

default: false

files

files.includesstring[]

Glob patterns relative to the configuration directory. A single star stops at directory separators; a double star crosses them. When omitted, every Dart file is a candidate.

linter

linter.enabledboolean

Master switch for the single-file linter. Set to false to disable all file rules. Defaults to true.

default: true
linter.domains.flutterstring

Activation level for the `flutter` domain's rules: `all` enables every rule in the domain, `recommended` only its recommended rules, `none` disables them.

values: all | recommended | none
linter.domains.teststring

Activation level for the `test` domain's rules: `all` enables every rule in the domain, `recommended` only its recommended rules, `none` disables them.

values: all | recommended | none
linter.domains.blocstring

Activation level for the `bloc` domain's rules: `all` enables every rule in the domain, `recommended` only its recommended rules, `none` disables them.

values: all | recommended | none
linter.domains.riverpodstring

Activation level for the `riverpod` domain's rules: `all` enables every rule in the domain, `recommended` only its recommended rules, `none` disables them.

values: all | recommended | none
linter.domains.providerstring

Activation level for the `provider` domain's rules: `all` enables every rule in the domain, `recommended` only its recommended rules, `none` disables them.

values: all | recommended | none
linter.domains.flutter_hooksstring

Activation level for the `flutter_hooks` domain's rules: `all` enables every rule in the domain, `recommended` only its recommended rules, `none` disables them.

values: all | recommended | none
linter.domains.equatablestring

Activation level for the `equatable` domain's rules: `all` enables every rule in the domain, `recommended` only its recommended rules, `none` disables them.

values: all | recommended | none
linter.rules.<group>.<rule>rule level (or object with level + options)

A severity level, or an object with a severity level, rule-specific options and an optional autofix policy.

values: off | on | info | warn | errorbrowse rule ids →

cross-file

cross-file.enabledboolean

Master switch for cross-file analysis. Set to false to disable all cross-file rules. Defaults to true.

default: true
cross-file.rules.<group>.<rule>rule level (or object with level + options)

A severity level, or an object with a severity level, rule-specific options and an optional autofix policy.

values: off | on | info | warn | errorbrowse rule ids →

overrides

overrides[].includesstring[]

Glob patterns relative to the configuration directory selecting the files this override applies to. Omitted patterns apply to every file.

overrides[].linter.enabledboolean | null

Master switch for the single-file linter within this override.

overrides[].linter.rules.<group>.<rule>rule level (or object with level + options)

A severity level, or an object with a severity level, rule-specific options and an optional autofix policy.

values: off | on | info | warn | errorbrowse rule ids →
overrides[].cross-file.enabledboolean | null

Master switch for cross-file analysis within this override.

overrides[].cross-file.rules.<group>.<rule>rule level (or object with level + options)

A severity level, or an object with a severity level, rule-specific options and an optional autofix policy.

values: off | on | info | warn | errorbrowse rule ids →

max-errors

max-errorsinteger | null

Print at most this many diagnostics without changing the exit code. Null (the default) means no limit. Must be at least 1 in configuration; use the CLI flag to hide all output.

default: null