# grunt-contrib-cssmin

> Minify CSS

Latest version **5.0.0** (published 2023-04-30) · MIT license · 0 weekly downloads

## Install

```sh
npm install grunt-contrib-cssmin
pnpm add grunt-contrib-cssmin
yarn add grunt-contrib-cssmin
bun add grunt-contrib-cssmin
```

## Health

**Score 25/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned.

## Facts

| | |
|---|---|
| Version | 5.0.0 |
| Published | 2023-04-30 |
| First published | 2013-02-16 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=14.0 |
| Dependencies | 3 |
| Unpacked size | 8.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 788 |
| Author | Grunt Team |
| Maintainers | cowboy, jzaefferer, jmeas, tkellen, vladikoff, shama, xhmikosr |
| Keywords | gruntplugin, cssmin, css, style, styles, stylesheet, minify, compress |

## Links

- npm: https://www.npmjs.com/package/grunt-contrib-cssmin
- Repository: https://github.com/gruntjs/grunt-contrib-cssmin
- Homepage: https://github.com/gruntjs/grunt-contrib-cssmin#readme
- Issues: https://github.com/gruntjs/grunt-contrib-cssmin/issues
- npm.io page: https://npm.io/package/grunt-contrib-cssmin

## Dependencies (3)

- [chalk](https://npm.io/package/chalk.md) ^4.1.2
- [maxmin](https://npm.io/package/maxmin.md) ^3.0.0
- [clean-css](https://npm.io/package/clean-css.md) ^5.3.2

## Alternatives

- [style-dictionary](https://npm.io/package/style-dictionary.md) — 2.0M weekly downloads
- [postcss-merge-idents](https://npm.io/package/postcss-merge-idents.md) — 1.7M weekly downloads
- [@fontsource/noto-sans](https://npm.io/package/@fontsource/noto-sans.md) — 93.0K weekly downloads
- [uglifycss](https://npm.io/package/uglifycss.md) — 71.6K weekly downloads
- [mat4-interpolate](https://npm.io/package/mat4-interpolate.md) — 23.3K weekly downloads

## Recent versions

- 5.0.0 (latest) — 2023-04-30
- 4.0.0 — 2021-02-15
- 3.0.0 — 2018-09-06
- 2.2.1 — 2017-07-27
- 2.2.0 — 2017-05-10
- 2.1.0 — 2017-04-17
- 2.0.0 — 2017-02-14
- 1.0.2 — 2016-09-01
- 1.0.1 — 2016-03-16
- 1.0.0 — 2016-03-04
- 0.14.0 — 2015-09-15
- 0.13.0 — 2015-07-27
- 0.12.3 — 2015-05-09
- 0.12.2 — 2015-02-20
- 0.12.1 — 2015-02-09
- … 13 more at https://npm.io/package/grunt-contrib-cssmin/versions

## README

# grunt-contrib-cssmin v4.0.0 [![Build Status](https://github.com/gruntjs/grunt-contrib-cssmin/workflows/Tests/badge.svg)](https://github.com/gruntjs/grunt-contrib-cssmin/actions?workflow=Tests)

> Minify CSS



## Getting Started

If you haven't used [Grunt](https://gruntjs.com/) before, be sure to check out the [Getting Started](https://gruntjs.com/getting-started) guide, as it explains how to create a [Gruntfile](https://gruntjs.com/sample-gruntfile) as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

```shell
npm install grunt-contrib-cssmin --save-dev
```

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

```js
grunt.loadNpmTasks('grunt-contrib-cssmin');
```

**Issues with the output should be reported on the clean-css [issue tracker](https://github.com/jakubpawlowicz/clean-css/issues).**



## Cssmin task
_Run this task with the `grunt cssmin` command._


### Options

Options are passed to [clean-css](https://github.com/jakubpawlowicz/clean-css#how-to-use-clean-css-api). In addition this task defines some extra options:


#### report

Type: `string`  
Choices: `'min'`, `'gzip'`  
Default: `'min'`

Report minification result or both minification and gzip results.
This is useful to see exactly how well clean-css is performing but using `'gzip'` will make the task take 5-10x longer to complete. [Example output](https://github.com/sindresorhus/maxmin#readme).


#### sourceMap

Type: `boolean`  
Choices: `true`, `false`  
Default: `false`

Enable Source Maps.

### Usage

#### Combine two files into one output file

```js
cssmin: {
  options: {
    mergeIntoShorthands: false,
    roundingPrecision: -1
  },
  target: {
    files: {
      'output.css': ['foo.css', 'bar.css']
    }
  }
}
```

#### Minify all contents of a release directory and add a `.min.css` extension

```js
cssmin: {
  target: {
    files: [{
      expand: true,
      cwd: 'release/css',
      src: ['*.css', '!*.min.css'],
      dest: 'release/css',
      ext: '.min.css'
    }]
  }
}
```


## Release History

 * 2023-05-01   v5.0.0   Update dependencies. Drop Node.js < 14 support.
 * 2021-02-15   v4.0.0   Update all dependencies including clean-css v5.x. Drop Node.js < 10 support.
 * 2018-09-07   v3.0.0   Update all dependencies. Drop Node.js < 6 support.
 * 2017-07-27   v2.2.1   Fix issue with `relativeTo` for clean-css v4.x.
 * 2017-05-10   v2.2.0   Update clean-css to v4.1.1.
 * 2017-04-17   v2.1.0   Set required Node.js version to >=4 since clean-css 4.x requires that.
 * 2017-02-02   v2.0.0   Update clean-css to v4.0.3.
 * 2016-08-31   v1.0.2   Fix issues for node 6.
 * 2016-03-16   v1.0.1   Downgrade maxmin to support Node.js 0.10.
 * 2016-03-04   v1.0.0   Updated docs. Point main to task and removed peerDeps. Update clean-css to v3.4.1.
 * 2015-09-15   v0.14.0   Bump to cssmin ~3.4.0. Minor test fixes.
 * 2015-07-27   v0.13.0   Bump to cssmin ~3.3.0.
 * 2015-05-09   v0.12.3   Improve reporting of errors and warnings. Log out written files and the saved size. Fix absolute paths.
 * 2015-02-20   v0.12.2   Set the `rebase` option to `false` by default.
 * 2015-02-09   v0.12.0   Add `sourceMap` option.
 * 2014-12-24   v0.11.0   Bump `clean-css` to 3.0.1. Remove `banner` option.
 * 2014-06-11   v0.10.0   Update clean-css v2.2.0.
 * 2014-02-01   v0.9.0   Refactor. Remove grunt-lib-contrib dependency. Backwards-compatibly remove `false` choice from `report`.
 * 2014-02-14   v0.8.0   Update clean-css v2.1.0.
 * 2013-11-23   v0.7.0   Update clean-css v2.0.0.
 * 2013-09-14   v0.6.2   Support relative URLs via clean-css ~1.1.1.
 * 2013-05-25   v0.6.1   Support import in-lining via clean-css ~1.0.4.
 * 2013-04-05   v0.6.0   Update clean-css dependency to ~1.0.0.
 * 2013-03-14   v0.5.0   Support for `report` option (false by default).
 * 2013-03-10   v0.4.2   Add `banner` option. Support clean-css `keepSpecialComments`.
 * 2013-02-17   v0.4.1   Update clean-css dependency to ~0.10.0.
 * 2013-02-15   v0.4.0   First official release for Grunt 0.4.0.
 * 2013-01-23   v0.4.0rc7   Updating grunt/gruntplugin dependencies to rc7. Changing in-development grunt/gruntplugin dependency versions from tilde version ranges to specific versions.
 * 2013-01-09   v0.4.0rc5   Updating to work with grunt v0.4.0rc5. Switching to `this.files` API.
 * 2012-11-01   v0.3.2   Update clean-css dep.
 * 2012-10-12   v0.3.1   Rename grunt-contrib-lib dep to grunt-lib-contrib.
 * 2012-09-23   v0.3.0   Options no longer accepted from global config key.
 * 2012-09-10   v0.2.0   Refactored from grunt-contrib into individual repo.

---

Task submitted by [Tim Branyen](http://tbranyen.com/)

*This is a generated file.*

---
_Source: https://npm.io/package/grunt-contrib-cssmin · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._