|     | Your help is appreciated! Create a PR or just buy me a coffee | | ---------------------------------------------------------- | ---------------------------------------------------------------------------------------- |

uglify-js-minify-css-allfiles

A powerful tool to minify and obfuscate JavaScript and CSS files in your project.
It helps protect your code in deployment environments and makes it less recognizable to others, all through a simple CLI interface.
You can easily minify all files in a specific folder, with the option to exclude certain directories.

Table of Contents

• Installation
• Usage
• Parameters
• Options
• Minification Options
• Changelog
• License

Installation

Install with npm:

$ npm i uglify-js-minify-css-allfiles

Usage

1. Basic usage (no Babel):

   import minifyAll from 'uglify-js-minify-css-allfiles';
   
   await minifyAll('./src/');

2. Using options:

   import minifyAll from 'uglify-js-minify-css-allfiles';
   
   await minifyAll('./src/', {
     excludeFolder: 'node_modules',
     useBabel: {
       targets: 'chrome 40',
       modules: false,
       useBuiltIns: 'usage',
       corejs: 3,
     },
     useLog: {
       logDir: 'logs',
       retentionDays: 30,
       logLevel: 'info',
       dateFormat: 'YYYY-MM-DD',
       timeZone: 'UTC',
       logToConsole: true,
       logToFile: true,
     },
     jsMinifyOptions: {
       compress: {
         dead_code: true,
         drop_debugger: true,
         conditionals: true,
         evaluate: true,
         booleans: true,
         loops: true,
         unused: true,
         hoist_funs: true,
         keep_fargs: false,
         hoist_vars: true,
         if_return: true,
         join_vars: true,
         cascade: true,
         side_effects: true,
         warnings: false,
       },
     },
     cssMinifyOptions: {
       level: 2,
     },
   });

Parameters

The minifyAll function accepts the following parameters:

| Parameter | Type | Default | Description | | ------------- | ------ | ------- | -------------------------------------------------------------------------------------------- | | contentPath | string | - | The path to the directory containing the files to be minified. This is a required parameter. | | options | object | {} | An object containing options for minification, Babel, and logging. |

Options

The options object can have the following properties:

| Property | Type | Default | Description | | ------------------ | ----------------- | ------- | ------------------------------------------------------------------------------------------ | | excludeFolder | string | '' | The name of a folder to exclude from minification. | | useBabel | boolean | object | false | If true, enables Babel with default settings. If an object, specifies Babel options. | | useLog | boolean | object | true | If true, enables logging with default settings. If an object, specifies logging options. | | jsMinifyOptions | object | {} | Options for JavaScript minification (passed to UglifyJS). | | cssMinifyOptions | object | {} | Options for CSS minification (passed to CleanCSS). |

Babel Options

When useBabel is an object, it can have the following properties:

| Property | Type | Description | | ------------------------------------- | --------------------------- | --------------------------------------------------------------------------------------------------------- | | targets | string | object | Specifies the target environments. | | modules | string | false | Enables transformation of ES6 module syntax to another module type. | | useBuiltIns | 'usage' | 'entry' | false | Configures how babel-preset-env handles polyfills. | | corejs | number | object | Specifies the core-js version. | | ... (other @babel/preset-env options) | Various | Refer to @babel/preset-env documentation for more options. |

Log Options

When useLog is an object, it can have the following properties:

| Property | Type | Default | Description | | --------------- | ------- | -------------- | --------------------------------------------------------------------- | | logDir | string | 'logs' | Specifies the directory for log files. | | retentionDays | number | 30 | Number of days to retain log files. | | logLevel | string | 'info' | Specifies the level of logging (e.g., 'info', 'warn', 'error'). | | dateFormat | string | 'YYYY-MM-DD' | Format for the date in log entries. | | timeZone | string | 'UTC' | Time zone for timestamps in log entries. | | logToConsole | boolean | true | Determines if logs should also be output to the console. | | logToFile | boolean | true | Determines if logs should be written to a file. |

Minification Options

JavaScript Minification Options

The jsMinifyOptions object is passed directly to UglifyJS. For a full list of available options, please refer to the UglifyJS documentation.

Some commonly used options include:

• compress: An object specifying compression options.
• mangle: Controls name mangling. Can be a boolean or an object with more specific options.
• output: An object controlling the output format.

CSS Minification Options

The cssMinifyOptions object is passed directly to Clean-CSS. For a full list of available options, please refer to the Clean-CSS documentation.

Some commonly used options include:

• level: Optimization level (0, 1, or 2).
• compatibility: Browser compatibility (e.g., 'ie7', '*').
• format: Output formatting options.

Changelog

See CHANGELOG.md for details on each release.

Changelog

License

MIT. See LICENSE.md for details.