📂 Package Minifier

Recursively Minify/Uglify JS, CSS, and HTML Files in a Directory While Preserving Folder Structure!

✨ Features

✅ Minify/Uglify JavaScript files (with uglify-js)
✅ Minify CSS files (with clean-css)
✅ Minify HTML files (with html-minifier-terser)
✅ Preserve original folder structure
✅ Highly configurable via package-minifier.config.js or package-minifier.config.ts
✅ Exclude specific files or folders
✅ Simple CLI interface
✅ Works recursively across folders

📦 Installation

npm install --save-dev package-minifier

🚀 Usage

After installation, you can run it from any directory under your project:

npx pkgmin

By default, it will:

1. Use the current working directory as the input folder.
2. Look for a config file named package-minifier.config.js in the current working directory (or use the default configuration).

🔧 Configuration

Place a file called package-minifier.config.js (or package-minifier.config.ts) in the root of your project directory.

Basic Example (package-minifier.config.js)

import {defineConfig} from "package-minifier";

export default defineConfig({
    excludeFiles: ["ignore.js", "skip-this.html"],
    excludeFolders: ["node_modules", "tests"],
    outputDir: "minified",

    html: {
        enabled: true,
        options: {
            collapseWhitespace: true,
            removeComments: true,
            minifyCSS: true,
            minifyJS: true
        }
    },
    css: {
        enabled: true,
        options: {
            level: 2
        }
    },
    js: {
        enabled: true,
        options: {
            compress: {
                drop_console: true
            },
            mangle: true,
            output: {
                comments: false
            }
        }
    }
});

📁 How It Works

| Step | What Happens | | ---- | ------------------------------------------------------------ | | 1 | Recursively traverses files in the current working directory | | 2 | Minifies JS, CSS, and HTML based on your config options | | 3 | Copies other file types unchanged | | 4 | Preserves the original folder structure | | 5 | Outputs everything into the outputDir directory |

🛠 Options Explained

| Option | Type | Description | | ---------------- | ---------- | --------------------------------------------------------------------------------------- | | excludeFiles | string[] | List of files to exclude | | excludeFolders | string[] | List of folders to exclude (recursively) | | outputDir | string | Output directory path (relative to current working dir) | | js.enabled | boolean | Enable/disable JS minification/uglification | | js.options | object | Options passed to uglify-js (see docs) | | css.enabled | boolean | Enable/disable CSS minification | | css.options | object | Options passed to clean-css (see docs) | | html.enabled | boolean | Enable/disable HTML minification | | html.options | object | Options passed to html-minifier-terser (see docs) |

✅ Example Folder Structure

project/
├── src/
│   ├── index.html
│   ├── style.css
│   └── scripts/
│       └── app.js
├── package-minifier.config.js
└── minified/    <-- outputDir (generated)

✅ Contributing

Pull requests are welcome! Here's how to contribute:

1. Fork the repo
2. Create a new branch
3. Commit your changes
4. Submit a PR 🚀

✅ License

MIT License © Syed Abdullah