Quickly identify unused files in your project to help slim down your codebase.

中文文档：https://github.com/laoer536/minipp/blob/main/README.zh.md

Rust version: https://github.com/laoer536/minipp-rs

• TypeScript: .ts, .tsx
• Style files: .css, .less, .scss
• Media files: .png, .jpg, .jpeg, .gif, .svg, .mp3, .mp4, .wav, .woff, .woff2, .ttf, .eot, .json

1. TypeScript/TSX Files:

   • ES Module import statements
   • Static import paths
   • Relative path imports
   • TypeScript path aliases (e.g., @/*) // Supported by default
   • Dynamic import() statements

2. Style Files:

   • @import statements
   • Resource references in url() functions
   • Relative path references
   • Path alias references

Create a minipp.config.ts file in the project root:

import { defineMinippConfig } from 'minipp'

export default defineMinippConfig({
  ignoreFiles: ['src/index.ts', 'src/core/cli/index.ts'],
  ignoreDependencies: ['@types/node'],
})

Glob patterns are also supported:

export default defineMinippConfig({
   needDel: false,
   ignoreFiles: ['src/index.ts', 'src/core/**'],
   ignoreDependencies: ['@types*'],
})

1. High Performance:

   • Fast analysis even in large projects
   • Optimized file scanning algorithm
   • Efficient memory usage

2. Comprehensive Analysis:

   • Supports multiple file types (TypeScript, TSX, CSS, media files, etc.)
   • Handles various import methods and path aliases
   • Detailed JSON report output

3. Developer-Friendly:

   • Simple command-line interface
   • Clear and detailed output format
   • Easy integration into existing workflows

4. Project Optimization:

   • Identifies and removes unused files
   • Reduces project size
   • Improves codebase maintainability

1. Dynamic Imports:

   • Template string paths are not supported
   • Conditional imports are not supported

2. CommonJS Modules:

   • require() syntax is not supported
   • Webpack-specific syntax like require.context() is not supported
   • module.exports and exports are not supported

3. Path Resolution:

   • Runtime dynamically constructed paths are not supported
   • Custom path aliases (other than @/) are not supported (default @/ is resolved to src/)
   • Complex path mapping rules (e.g., multiple wildcards) are not supported

4. Special Syntax:

   • CSS-in-JS style references are not supported
   • Vue single-file component dependency resolution is not supported

1. Accuracy:
   • For files loaded automatically at runtime (without explicit imports in code), the tool cannot determine if they are used (currently classified as unused). Users must manually verify such files before deletion.

npm install minipp -D

yarn add minipp -D

pnpm add minipp -D

import { defineMinippConfig } from 'minipp'

export default defineMinippConfig({
  ignoreFiles: ['src/index.ts', 'src/core/cli/index.ts'],
  ignoreDependencies: ['@types/node'],
})

Glob patterns are also supported:

export default defineMinippConfig({
   needDel: false,
   ignoreFiles: ['src/index.ts', 'src/core/**'],
   ignoreDependencies: ['@types*'],
})

You can also install it globally:

npm install minipp -g

Don't forget to create minipp.config.ts in the target project's root directory.

minipp

minipp /path/to/your/project

1. Path Aliases:

{
   "compilerOptions": {
      "baseUrl": ".",
      "paths": {
         "@/*": ["./src/*"] // Supported by default
      }
   }
}

2. Usage Examples:

// Relative path imports
import { Button } from './components/Button';
import { Button } from '../../components/Button';
import { Button } from '../components/Button';

// Path alias imports
import { utils } from '@/utils'; // Resolved as "src/utils"
import { config } from '@config/settings'; // Treated as an external dependency, not a local resource

// BaseUrl imports
import { types } from 'types';

1. @/utils -> src/utils
2. ./utils -> Resolved relative to the current file's directory
3. ../utils -> Resolved relative to the parent directory of the current file (supports '../../utils', '..', etc.)

• Import information in code files
• Import information in CSS/LESS/SCSS files
• Unused file information
• Unused dependencies in code
• Used dependencies in code

Example:

{
   "jsLikePathImports": [
      "src/core/processors/js-like.ts",
      "src/core/processors/style-like.ts",
      "src/core/common/index.ts",
      "src/core/cli/index.ts",
      "src/core/visitor/index.ts"
   ],
   "jsLikeDependenceImports": [
      "fs",
      "path",
      "glob",
      "yocto-spinner",
      "util",
      "@swc/core"
   ],
   "styleLikeImports": [],
   "unusedFile": [
      "src/index.ts"
   ],
   "codeUnusedDependencies": [
      "@swc/cli",
      "@types/node",
      "@typescript-eslint/eslint-plugin",
      "@typescript-eslint/parser",
      "changelogen",
      "eslint",
      "prettier",
      "tsconfig-paths",
      "tsx",
      "typescript",
      "unbuild"
   ]
}

1. It is recommended to run the tool in the project root directory.

1. Support for JavaScript and JSX parsing
2. Support for Vue single-file components