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
$schemastringURL of the falcon.json JSON Schema, enabling rule autocomplete and level validation in editors.
cross-file
cross-file.enabledbooleanMaster switch for cross-file analysis. Set to false to disable all cross-file rules. Defaults to true.
cross-file.rules.recommendedbooleanEnable the recommended preset for this section. When on, every rule in the preset reports at its default severity unless individually overridden. Defaults to true.
cross-file.rules.<group>.<rule>rule level (or object with level + options)A rule's configuration: either a bare severity level, or an object with a `level` and rule-specific `options`.
files
files.includesstring[]Glob patterns for the files falcon analyzes. When omitted, every Dart file under the working directory is analyzed.
linter
linter.domains.flutterstringActivation level for the `flutter` domain's rules: `all` enables every rule in the domain, `recommended` only its recommended rules, `none` disables them.
linter.enabledbooleanMaster switch for the single-file linter. Set to false to disable all file rules. Defaults to true.
linter.rules.recommendedbooleanEnable the recommended preset for this section. When on, every rule in the preset reports at its default severity unless individually overridden. Defaults to true.
linter.rules.<group>.<rule>rule level (or object with level + options)A rule's configuration: either a bare severity level, or an object with a `level` and rule-specific `options`.
max-errors
max-errorsinteger | nullStop after emitting this many diagnostics. Null (the default) means no limit.
overrides
overrides[].cross-file.enabledbooleanMaster switch for cross-file analysis within this override.
overrides[].cross-file.rules.recommendedbooleanEnable the recommended preset for this section. When on, every rule in the preset reports at its default severity unless individually overridden. Defaults to true.
overrides[].cross-file.rules.<group>.<rule>rule level (or object with level + options)A rule's configuration: either a bare severity level, or an object with a `level` and rule-specific `options`.
overrides[].includesstring[]Glob patterns selecting the files this override applies to.
overrides[].linter.enabledbooleanMaster switch for the single-file linter within this override.
overrides[].linter.rules.recommendedbooleanEnable the recommended preset for this section. When on, every rule in the preset reports at its default severity unless individually overridden. Defaults to true.
overrides[].linter.rules.<group>.<rule>rule level (or object with level + options)A rule's configuration: either a bare severity level, or an object with a `level` and rule-specific `options`.