{"id":41193,"library":"gulp-csscomb","title":"gulp-csscomb","description":"Gulp plugin for CSScomb, a CSS coding style formatter that automatically sorts and formats CSS properties according to a configurable style guide. Version 3.1.0 (latest) runs on Node >= 0.9.0. It integrates CSScomb into Gulp build pipelines, supporting custom config files (.csscomb.json) and predefined presets like 'zen'. Differentiated by being a direct wrapper around the standalone CSScomb.js library, it is lightweight and has no external dependencies beyond CSScomb itself. However, the project has been in maintenance mode since 2018, with CSScomb.js itself deprecated in favor of stylelint.","status":"maintenance","version":"3.1.0","language":"javascript","source_language":"en","source_url":"ssh://git@github.com/koistya/gulp-csscomb","tags":["javascript","gulpplugin","css","csscomb","lint","linter","preprocessor"],"install":[{"cmd":"npm install gulp-csscomb","lang":"bash","label":"npm"},{"cmd":"yarn add gulp-csscomb","lang":"bash","label":"yarn"},{"cmd":"pnpm add gulp-csscomb","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Core CSScomb library that does the actual CSS formatting","package":"csscomb","optional":false}],"imports":[{"note":"Since v4.0.0 the package is ESM-only, but this version (3.1.0) supports CommonJS. For latest, use ESM syntax.","wrong":"var csscomb = require('gulp-csscomb');","symbol":"gulp-csscomb","correct":"import csscomb from 'gulp-csscomb';"},{"note":"CommonJS require is the standard for this legacy package. ESM import may work if the consuming project is ESM, but the package itself is CJS.","wrong":"import csscomb from 'gulp-csscomb';\n// Works only if your project is ESM","symbol":"csscomb","correct":"const csscomb = require('gulp-csscomb');"},{"note":"The package exports a single function directly, not as a named export. Destructuring will result in undefined.","wrong":"const { csscomb } = require('gulp-csscomb');","symbol":"default export","correct":"const csscomb = require('gulp-csscomb');\ncsscomb()"}],"quickstart":{"code":"const gulp = require('gulp');\nconst csscomb = require('gulp-csscomb');\n\ngulp.task('comb', () => {\n  return gulp.src('src/**/*.css')\n    .pipe(csscomb('zen'))\n    .pipe(gulp.dest('dist'));\n});","lang":"javascript","description":"Shows how to use gulp-csscomb with a predefined preset ('zen') to format CSS files in a Gulp task."},"warnings":[{"fix":"Migrate to stylelint with stylelint-config-standard or similar.","message":"CSScomb is deprecated in favor of stylelint. This plugin is in maintenance mode and will not receive new features.","severity":"deprecated","affected_versions":"*"},{"fix":"If on Node >=14 and using ESM, update to v4; otherwise stay on v3 and pin to 3.1.0.","message":"Version 4.0.0 drops Node.js support for versions < 14 and switches to ESM-only. If you are on an older Node or CJS, stick with v3.x.","severity":"breaking","affected_versions":">=4.0.0"},{"fix":"Ensure no .csscomb.json exists if you intend to use a preset, or rename/remove it.","message":"If a .csscomb.json file is present in the same folder as the source files or project root, it overrides the preset argument. This can be surprising if you pass a preset but have a config file.","severity":"gotcha","affected_versions":"*"}],"env_vars":null,"search_vec":"'0.9.0':32 '2018':81 '3.1.0':27 'accord':20 'around':56 'automat':14 'beyond':69 'build':38 'code':10 'config':42 'configur':23 'css':9,18,92 'csscomb':3,7,35,70,93 'csscomb.js':59,83 'csscomb.json':44 'custom':41 'depend':68 'deprec':85 'differenti':50 'direct':54 'extern':67 'favor':87 'file':43 'format':17 'formatt':12 'guid':25 'gulp':2,4,37 'gulp-csscomb':1 'gulpplugin':91 'howev':72 'integr':34 'javascript':90 'latest':28 'librari':60 'lightweight':63 'like':48 'lint':94 'linter':95 'mainten':78 'mode':79 'node':31 'pipelin':39 'plugin':5 'predefin':46 'preprocessor':96 'preset':47 'project':74 'properti':19 'run':29 'sinc':80 'sort':15 'standalon':58 'style':11,24 'stylelint':89 'support':40 'version':26 'wrapper':55 'zen':49","created_at":"2026-06-04T18:51:13.491124+00:00","updated_at":"2026-06-04T18:51:13.491124+00:00","problems":[{"fix":"Run 'npm install gulp-csscomb --save-dev'.","cause":"Package not installed or missing from node_modules.","error":"Error: Cannot find module 'gulp-csscomb'"},{"fix":"Use 'const csscomb = require('gulp-csscomb');' (CommonJS) or 'import csscomb from 'gulp-csscomb';' (ESM) correctly.","cause":"Incorrect import: try to destructure as { csscomb } or misunderstanding of the export style.","error":"TypeError: csscomb is not a function"},{"fix":"Pass either a string (preset name) or an options object (e.g., csscomb({...})).","cause":"Passed an array, number, or other invalid type to csscomb().","error":"gulp-csscomb: Options must be a string or object."}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"http://github.com/koistya/gulp-csscomb","github":"ssh://git@github.com/koistya/gulp-csscomb","docs":null,"changelog":null,"pypi":null,"npm":"gulp-csscomb","openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-04","next_check":"2026-09-02","install_tag":null}}