tsx-prune

Analyze and safely remove unused components, files, imports, and exports in TypeScript/React codebases.

Features

• Unused file detection — find files unreachable from your entry points
• Unused export detection — find exports never imported anywhere
• Unused import detection — find and remove imports not used in the file body
• React component detection — detect JSX components never referenced anywhere
• Safe deletion — never deletes test files, stories, or spec files
• Config file support — tsx-prune.config.ts / tsx-prune.config.json
• tsconfig path aliases — respects baseUrl and paths from your tsconfig.json
• JSON output — machine-readable output for CI pipelines
• Fast — uses ts-morph AST cache and fast-glob for 10k+ file projects

Installation

# Global install
bun add -g tsx-prune
npm install -g tsx-prune

# Or use without installing
bunx tsx-prune
npx tsx-prune

Usage

# Dry run (default) — shows what would be removed
tsx-prune

# Delete unused files
tsx-prune --delete

# Remove unused imports
tsx-prune --fix-imports

# Remove export modifier from unused exports
tsx-prune --fix-exports

# All fixes together
tsx-prune --delete --fix-imports --fix-exports

# Custom entry points
tsx-prune --entry src/main.tsx src/server.ts

# Ignore patterns
tsx-prune --ignore "src/legacy/**" "src/vendor/**"

# JSON output (for CI)
tsx-prune --json

# Silent mode
tsx-prune --silent

# Custom tsconfig
tsx-prune --tsconfig tsconfig.app.json

# Use a config file
tsx-prune --config tsx-prune.config.ts

Example Output

  Scanning 342 files...
  Entry points: 3 found

  Unused Files:
    ✗ src/components/OldCard.tsx
    ✗ src/utils/legacyHelpers.ts
    2 unused files found

  Unused Exports:
    src/components/Button.tsx
      ✗ <ButtonGroup>
      ✗ ButtonSize

    1 file with unused exports

  Unused React Components:
    <ButtonGroup>, <CardVariant>
    2 unused components found

  ─────────────────────────────────────────
  Summary: 342 files scanned
    ✗ 2 unused files
    ✗ 2 unused exports
    ✗ 2 unused React components

  Dry run complete. Use --delete to remove files.

Configuration File

Create tsx-prune.config.ts (or .json) at your project root:

// tsx-prune.config.ts
export default {
  entry: ["src/main.tsx", "src/server.ts"],
  ignore: [
    "src/legacy/**",
    "src/vendor/**",
    "**/*.generated.ts",
  ],
};

// tsx-prune.config.json
{
  "entry": ["src/main.tsx"],
  "ignore": ["src/legacy/**"]
}

Options

Default Entry Points

When no --entry is specified, tsx-prune looks for:

• src/main.tsx / src/main.ts
• src/index.tsx / src/index.ts
• src/app.tsx / src/App.tsx
• src/pages/** (Next.js pages router)
• src/app/** (Next.js app router)
• pages/**
• app/**

Safety Rules

tsx-prune never deletes:

• *.test.ts / *.test.tsx
• *.spec.ts / *.spec.tsx
• *.stories.tsx / *.stories.ts
• Files inside __tests__/ or tests/
• Files inside .storybook/
• Files with dynamic imports pointing to them

Comparison

Programmatic API

import {
  scanFiles,
  Parser,
  buildGraphFromFileInfos,
  analyze,
  reportAnalysis,
} from "tsx-prune";

const files = await scanFiles({
  root: "./src",
  extensions: [".ts", ".tsx"],
  ignore: [],
  entry: [],
});

const parser = new Parser({
  tsconfig: "./tsconfig.json",
  root: "./src",
  extensions: [".ts", ".tsx"],
});

parser.addFiles(files);
const fileInfos = new Map(files.map((f) => [f, parser.parseFile(f)]));

const graph = buildGraphFromFileInfos(fileInfos);
const result = analyze(graph, fileInfos, {
  entryPoints: ["./src/main.tsx"],
  ignorePatterns: [],
});

reportAnalysis(result, { json: false, silent: false, cwd: process.cwd() });

Development

# Install dependencies
bun install

# Build
bun run build

# Run directly (no build step needed with Bun)
bun run src/cli.ts

# Type-check
bun run lint

# Test
bun test

License

MIT