Devoid

Dead-Code Analysis for JavaScript & TypeScript

Devoid is a fast static analyzer that detects:

- Unused exports
- Unused local identifiers (functions, variables, classes, types)
- Unused files
- Incorrect or unreachable re-exports
- Usage propagation through wildcards and barrel modules
- Import resolution via TS path aliases, directory imports, and relative paths

Devoid is powered the TypeScript Compiler API directly at runtime — no other dependencies.

---

Installation

$3

``sh
npm install -g devoid


or

pnpm add -g devoid

or

yarn global add devoid
`

$3

`sh
npm install -D devoid


or

pnpm add -D devoid

or

yarn add -D devoid
`

CLI Usage

`sh
devoid src/
`

Common Flags

`sh
devoid src/ --exports
devoid src/ --files
devoid src/ --locals
devoid src/ --json
`

Analysis Modes

$3

List exports that are never imported or referenced:

`sh
devoid src/ --exports
`

$3

List files that are unreachable from the entrypoints and have no side effects:

`sh
devoid src/ --files
`

$3

Detect unused classes, enums, functions, and variables within files:

`sh
devoid src/ --locals


or


devoid src/ --identifiers
`

Enable strict mode to include type declarations:

`sh
devoid src/ --locals --track-all-locals
`

$3

Detect unused exported types and local type declarations:

`sh
devoid src/ --types
`

Types mode:
- Tracks type and interface usage only
- Respects import type and export type
- Follows barrel and wildcard type re-exports
- Does not require the TypeScript type checker
- Does not affect runtime export analysis




Output Options

$3

`sh
devoid src/ --json
`

$3

`sh
devoid src/ --summary-only
`

$3

Print raw graphs for debugging:

`sh
devoid src/ --verbose
`

Internal (Single-File) Analysis

Analyze unused identifiers within a single file only:

`sh
devoid internal src/utils/helpers.ts
`

Enable strict local tracking:

`sh
devoid internal src/utils/helpers.ts --track-all-locals
`

Misc Options

$3

Ignore files or directories containing a substring:

`sh
devoid src/ --ignore dist --ignore generated
`

$3

`sh
devoid src/ --no-color
devoid src/ --color
``

License

MIT © Elijah Kotyluk