🔥 Why Fireliquidator?

Modern frontend frameworks (Next.js, Vite, Turbo) create heavy cache folders and build artifacts. When things break, the solution is often: "Delete node_modules and try again."

Doing this manually is annoying: rm -rf node_modules .next .turbo dist build ...

Fireliquidator detects these folders automatically and offers to "liquidate" them with a single keystroke.

🚀 Features

• Smart Detection: Automatically finds heavy folders like node_modules, .next, dist, build, .turbo, and coverage.
• Smart Detection: Automatically finds heavy folders like node_modules, .next, dist, build, .turbo, and coverage.
• Deep Space Scan: Calculates exactly how much space you will free up.
• Dry Run Mode: See what will be deleted without touching a file.
• Safety First: Asks for confirmation before deleting anything.
• Neon Aesthetics: Beautiful CLI interface with loading spinners and ASCII art.
• Framework Agnostic: Works with React, Next.js, Vue, Vite, and generic Node projects.

📦 Installation

Run it directly using npx (Recommended):

npx fireliquidator

Or install it globally to use it everywhere:

npm install -g fireliquidator-cli

💻 Usage

Navigate to your project folder and run:

fireliquidator

To skip the confirmation prompt:

fireliquidator --force

The tool will scan the current directory, list the "junk" artifacts it found, and ask for permission to liquidate them.

Example Output:

FIRELIQUIDATOR
/// PROJECT CLEANUP UTILITY ///

Found the following artifacts:
  🔥 node_modules (250 MB)
  🔥 .next (120 MB)
  🔥 .turbo (50 MB)

  Total Reclaimable Space: 420 MB

? Do you want to LIQUIDATE these folders? (Y/n)

Recursive Liquidation

To scan all subdirectories for artifacts (e.g., in a monorepo or folder with multiple projects):

fireliquidator --recursive
# OR
fireliquidator -r

Deep Clean (Docker Support)

To also remove unused Docker containers and images:

fireliquidator --docker

Dry Run (Safety Check)

To see exactly what will be deleted and how much space it takes without actually deleting anything:

fireliquidator --dry-run

🛠 Targeted Artifacts

Currently, Fireliquidator looks for and destroys:

• node_modules
• .next (Next.js build)
• dist (Vite/Webpack build)
• build (CRA build)
• .turbo (Turborepo cache)
• .cache (General cache)
• coverage (Test coverage reports)
• yarn.lock / package-lock.json (Optional cleaning)

🗺 Roadmap

• [x] v1.1: Add --force flag to skip confirmation.
• [x] v1.2: Add support for recursive scanning (clean multiple projects at once).
• [x] v1.3: Add Size Calculation (Space Freed) and Dry Run mode.
• [x] v2.0: "Deep Clean" mode to remove unused docker containers.

👤 Author

mrahulrahi

• 🌐 Website: mrahulrahi
• 📸 GuruShots: Rahi Creations
• 🐦 X/Twitter: @mrahulrahi