Configuration

{
  "entry": ["src/workers/*.ts", "scripts/*.ts", "src/cli.ts"]
}

{
  "ignorePatterns": ["**/*.generated.ts", "**/*.d.ts", "legacy/**"]
}

{
  "ignoreFindings": [
    "vitest.config.ts",
    "src/generated/**",
    // a leading ! keeps matching paths reportable
    "!src/generated/keep.ts"
  ]
}

{
  "ignoreDependencies": ["autoprefixer", "@types/node", "bun:sqlite"]
}

{
  "ignoreCatalogReferences": [
    // Placeholder package; the `upcoming` catalog lands in a later change.
    {
      "package": "future-dep",
      "catalog": "upcoming",
      "consumer": "packages/placeholder/package.json"
    },
    // Staged migration: any catalog, every workspace package.
    { "package": "old-react", "consumer": "packages/**/package.json" }
  ]
}

{
  "ignoreDependencyOverrides": [
    // overrides: { "lodash": "^4.17.21" } in pnpm-workspace.yaml
    // No source filter, so the entry matches in either file
    { "package": "lodash" },
    // pnpm.overrides: { "@scope/legacy-pkg": "^1.0.0" } in package.json
    { "package": "@scope/legacy-pkg", "source": "package.json" },
    // resolutions: { "**/trim-newlines": "^3.0.1" } in a bun package.json
    { "package": "trim-newlines", "source": "package.json" }
  ]
}

{
  "ignoreUnresolvedImports": [
    "@example/icons",     // the bare specifier
    "@example/icons/**",  // its subpaths, not the bare name
    "../generated/**"     // parent-relative codegen output
  ]
}

{
  "ignoreExports": [
    { "file": "src/index.ts", "exports": ["*"] },
    { "file": "src/utils/*.ts", "exports": ["default"] },
    // shadcn / Radix / bits-ui barrels
    { "file": "src/lib/components/ui/**", "exports": ["*"] }
  ]
}

{
  "ignoreExportsUsedInFile": true
}

{
  "ignoreExportsUsedInFile": { "type": true, "interface": true }
}

{
  "includeEntryExports": true
}

{
  "typeAware": {
    "enabled": true,
    "projects": ["tsconfig.json"],
    "require": "best-effort"
  }
}

{
  "security": {
    "requestReceivers": ["h", "httpReq"],
    "categories": {
      "include": ["command-injection"],
      "exclude": ["dynamic-regex"]
    }
  }
}

{
  "autoImports": true
}

{
  "ignoreDecorators": ["@step"]
}

{
  "rules": { "unused-component-props": "warn" },
  "unusedComponentProps": {
    "ignorePattern": "^_"
  }
}

<script lang="ts">
  interface Props { stage: string; variant?: string }
  // `_stage` is exempted by `^_`; `variant` is still reported if unused.
  let { stage: _stage, variant }: Props = $props();
</script>

{
  "usedClassMembers": [
    "agInit",
    { "implements": "ICellRendererAngularComp", "members": ["refresh"] },
    { "extends": "BaseCommand", "members": ["execute"] },
    { "implements": "CanActivate", "members": ["canActivate"] },
    { "extends": "GrammarBaseListener", "members": ["enter*", "exit*"] }
  ]
}

{
  "publicPackages": ["@myorg/sdk", "@myorg/types"]
}

{
  "dynamicallyLoaded": ["src/plugins/**/*.ts", "src/routes/**/page.tsx"]
}

{
  "duplicates": {
    "mode": "mild",
    "near": true,
    "minTokens": 50,
    "minLines": 5,
    "minOccurrences": 2,
    "threshold": 5,
    "ignore": ["**/*.generated.ts"],
    "ignoredClones": ["dup:6f12ab34:2"],
    "skipLocal": true,
    "ignoreImports": true
  }
}

{
  "similarCode": {
    "threshold": 0.8,
    "minLines": 3,
    "ignore": ["src/generated/**"]
  }
}

{
  "health": {
    "maxCyclomatic": 20,
    "maxCognitive": 15,
    "maxCrap": 30,
    "crapRefactorBand": 5,
    "ignore": ["**/*.generated.ts", "src/legacy/**"],
    "thresholdOverrides": [
      {
        "files": ["src/legacy/**"],
        "functions": ["parseLegacy"],
        "maxCyclomatic": 40,
        "maxCognitive": 35,
        "reason": "Queued legacy parser cleanup"
      },
      {
        "files": ["**/*.test.*", "**/*.spec.*"],
        "maxUnitSize": 500,
        "reason": "Test suites: describe/it blocks are long by design"
      }
    ],
    "suggestInlineSuppression": true
  }
}

{
  "audit": {
    "gate": "new-only",
    "css": true,
    "cssDeep": true,
    "cacheMaxAgeDays": 14
  }
}

[audit]
gate = "all"
css = true
cssDeep = true
cacheMaxAgeDays = 14

{
  "fix": {
    "catalog": {
      "deletePrecedingComments": "auto"
    }
  }
}

{
  "production": true
}

{
  "production": {
    "deadCode": false,
    "health": true,
    "dupes": false
  }
}

{
  "workspaces": {
    "patterns": ["tools/*", "shared/*"]
  }
}

{
  "extends": ["./configs/base.json", "./configs/strict.json"]
}

extends = ["./configs/base.json", "./configs/strict.toml"]

{
  "extends": [
    "./configs/local-overrides.json",
    "npm:@my-org/fallow-config",
    "https://example.com/shared/fallow-base.json"
  ]
}

{
  "minimumVersion": "3.21.0",
  "entry": ["src/main.ts"]
}

fallow.json requires fallow 3.21.0 or newer, running 3.19.0.
Upgrade fallow, or remove minimumVersion and the fields that need it.

{
  "overrides": [
    {
      "files": ["*.test.ts", "*.spec.ts"],
      "rules": {
        "unused-exports": "off"
      }
    },
    {
      "files": ["src/core/**/*.ts"],
      "rules": {
        "unused-exports": "error",
        "unused-types": "error"
      }
    }
  ]
}

[[overrides]]
files = ["*.test.ts", "*.spec.ts"]

[overrides.rules]
unused-exports = "off"

[[overrides]]
files = ["src/core/**/*.ts"]

[overrides.rules]
unused-exports = "error"
unused-types = "error"

{
  "sealed": true,
  "extends": ["./base.json"]
}

sealed = true
extends = ["./base.json"]

{
  "boundaries": {
    "preset": "bulletproof"
  }
}

{
  "rulePacks": ["./rule-packs/team-policy.jsonc"]
}

{
  "rules": {
    "unused-files": "warn",
    "unused-exports": "error",
    "circular-dependency": "off",
    "css-token-drift": "warn",
    "css-duplicate-block": "warn",
    "css-selector-complexity": "warn",
    "css-dead-surface": "warn",
    "css-broken-reference": "warn"
  }
}

{
  "flags": {
    "sdkPatterns": [
      { "function": "useFlag", "nameArg": 0, "provider": "LaunchDarkly" },
      { "function": "client.getFeatureValue", "nameArg": 0 }
    ],
    "envPrefixes": ["FEATURE_", "NEXT_PUBLIC_ENABLE_"],
    "configObjectHeuristics": false
  }
}

{
  "resolve": {
    "conditions": ["worker", "edge-light"]
  }
}

{
  "exports": {
    "./api": {
      "worker": "./src/api.worker.ts",
      "import": "./dist/api.js"
    }
  }
}

{
  "codeowners": ".github/CODEOWNERS"
}

{
  "framework": [
    {
      "name": "my-framework",
      "entry": ["src/server.ts"],
      "ignore": ["**/*.internal.ts"]
    }
  ]
}

{
  "plugins": ["./my-plugins/custom.toml", "./plugins/"]
}

{
  "cache": {
    "dir": "/tmp/fallow-cache",
    "maxSizeMb": 64
  }
}

{
  "regression": {
    "baseline": {
      "unused_files": 11,
      "unused_exports": 48,
      "unused_types": 5,
      "unused_dependencies": 3,
      "circular_dependencies": 1
    }
  }
}