Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »


    Merge CSS

    This library is an extension for the Clean CSS library to add merge multiple css files according to their dependencies on each other and produce a combined css file by minimizing the result.

    You can install the library through the Node Package Manager by running npm install merge-css.


    merge-css resolves dependencies between files and merges them into a single file. In order to define a dependency, simply use a commented import statement in your js files like this;

    // import("lib/head.css")
    // import("lib/test.css")
    body {
        margin: 0;

    Connect Middleware

    merge-css has been developed to be used primarily with Connect. Sample for activating merge-css in Express:

        src: __dirname + "/assets", 
        dest: __dirname + "/public" 

    In this case, merge looks up for the css files in /assets dir and compiles them to /public dir.


    The following options are supported:

    • src: Source directory of CSS files.
    • dest: Destination directory to place uglified files. If omitted, this will default to match src and your generated files will be suffixed with .merged.css rather than just .css.
    • uglify: Boolean indicating whether the code should be uglified at all.
    • ext: Boolean indicating whether to use the .merged.css extension for generated files.

    Developed By


    Copyright 2011 Ekin Koc
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at
    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.




    npm i merge-css

    Downloadsweekly downloads






    last publish


    • avatar