Skip to content

Configuration

Necro runs zero-config. To customize which files it analyzes, add a necro.config.json to your project root.

necro.config.json
{
"include": ["**/*.ts", "**/*.tsx"],
"ignore": ["**/node_modules/**", "**/dist/**"]
}
KeyTypeDefaultDescription
includestring[]["**/*.ts", "**/*.tsx"]Globs of files to analyze.
ignorestring[]["**/node_modules/**", "**/dist/**"]Globs to exclude.

Each key you set replaces its default (values are merged per key, not concatenated). If you set ignore, include the defaults you still want:

necro.config.json
{
"ignore": ["**/node_modules/**", "**/dist/**", "**/*.generated.ts"]
}

Declaration files (*.d.ts) and the directories node_modules, .git, dist, build, and coverage are always skipped.

Entry-point overrides, per-detector thresholds, and tier tuning are planned. Today, entry points are resolved automatically from package.json and your test-runner config.

See the full configuration reference for the authoritative key list.