🔨 Web-Crush

The Zero-Config Minifier for Vanilla Web Projects.

Great build tools already exist. But installing them, configuring them, and writing build scripts just to minify a simple project is time-consuming.

Web-Crush cuts out the setup. It takes your raw HTML, CSS, and JS, crushes them into a production-ready public folder, and gets out of your way.

⚡ Why?

We aren't trying to replace Vite or Webpack. They are excellent. But for a simple portfolio or landing page, setting up a complex build pipeline feels like overkill.

Web-Crush is for when you just want to finish:

• Zero Config: No setup. Just run it in your project's root folder, and boom—everything is done.
• Lightweight: Installs in seconds (~10MB).
• Recursive: Handles nested folders and complex structures automatically.

🚀 Usage

You don't even need to install it. Go to your project root and run:

npx web-crush-cli

What happens next?

1. Recursive Scan: It finds all .html, .css, and .js files in your root and every subfolder.
2. Minification: It compresses code using industry-standard engines (terser, clean-css, html-minifier).
3. Universal Passthrough: It automatically copies everything else (images, fonts, PDFs, robots.txt, favicon.ico) exactly as is, preserving the folder structure.
4. Deployment Ready: It outputs everything into a clean public/ folder.

⚙️ Configuration (Optional)

Happy with the defaults? Do nothing. Need control? Create a web-crush.config.json file in your project root:

{
  "outDir": "public",       // Default: "public"
  "verbose": true,          // Default: true
  "dropConsole": false,     // Default: false (Set to true to strip console.logs)
  "exclude": ["drafts/**"]  // Default: [] (Files/folders to ignore)
}

(Note: You no longer need to define an assets folder. Web-Crush now auto-detects assets anywhere in your project.)

🛡️ Features

1. Deep Recursion

No need to list your files. Whether your file is index.html or deeply nested in blog/2025/posts/article.html, Web-Crush finds it, minifies it, and outputs it to the correct folder.

2. Recruiter Safe Mode

Most minifiers strip console.log to save space. Web-Crush keeps them. Why? Because many developers leave "Hello there!" messages for technical recruiters in the console. We respect the hustle.

(Want them gone? Set "dropConsole": true in your config).

3. Universal Passthrough

Web-Crush scans for everything. If it's code, it gets crushed. If it's not code, it gets copied.

• ✅ favicon.ico in root? Copied.
• ✅ sitemap.xml or robots.txt? Copied.
• ✅ images/, fonts/, or videos/? Copied.

(Got something you don't want copied? Add it to exclude in your config).

📂 Example Structure

Before (npx web-crush-cli):

My-Portfolio/
├── images/
│   └── me.jpg
├── blog/
│   └── post-1.html  (Nested file)
├── index.html       (400 lines, messy)
├── style.css        (50kb, comments everywhere)
└── favicon.ico

After:

My-Portfolio/
├── public/          <-- DEPLOY THIS FOLDER
│   ├── images/      (Copied)
│   ├── blog/
│   │   └── post-1.html (Minified)
│   ├── index.html   (One line, tiny)
│   ├── style.css    (Compressed)
│   └── favicon.ico  (Copied)
└── ...

👤 Author

Anson Jaison

• Website: anson.is-a.dev
• GitHub: @ansonjaison
• LinkedIn: Anson Jaison

📄 License

MIT © Anson Jaison