{"id":15653182,"url":"https://github.com/jeffjewiss/broccoli-postcss","last_synced_at":"2025-08-20T03:30:42.467Z","repository":{"id":29344365,"uuid":"32878438","full_name":"jeffjewiss/broccoli-postcss","owner":"jeffjewiss","description":"🌳 Postcss compiler as a Broccoli filter.","archived":false,"fork":false,"pushed_at":"2023-03-06T14:57:05.000Z","size":3252,"stargazers_count":30,"open_issues_count":10,"forks_count":18,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-10-23T04:48:02.110Z","etag":null,"topics":["broccoli","broccoli-plugin","postcss","postcss-plugins"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jeffjewiss.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-03-25T16:57:00.000Z","updated_at":"2023-09-08T16:56:03.000Z","dependencies_parsed_at":"2024-06-18T13:56:00.939Z","dependency_job_id":"51055a85-aa95-4cc9-b095-8bdd6b455075","html_url":"https://github.com/jeffjewiss/broccoli-postcss","commit_stats":{"total_commits":597,"total_committers":22,"mean_commits":"27.136363636363637","dds":0.7252931323283083,"last_synced_commit":"7210b6d9e25338c858687045790f40cf810d75fb"},"previous_names":[],"tags_count":30,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeffjewiss%2Fbroccoli-postcss","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeffjewiss%2Fbroccoli-postcss/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeffjewiss%2Fbroccoli-postcss/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeffjewiss%2Fbroccoli-postcss/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jeffjewiss","download_url":"https://codeload.github.com/jeffjewiss/broccoli-postcss/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230184453,"owners_count":18186491,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["broccoli","broccoli-plugin","postcss","postcss-plugins"],"created_at":"2024-10-03T12:44:53.730Z","updated_at":"2024-12-19T06:09:07.467Z","avatar_url":"https://github.com/jeffjewiss.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# broccoli-postcss\n\n[![Build Status][build-img]][build-url]\n[![npm version][npm-img]][npm-url]\n[![Coverage Status][coveralls-img]][coveralls-url]\n[![monthly downloads][monthly-downloads-img]][monthly-downloads-url]\n[![total downloads][total-downloads-img]][total-downloads-url]\n\nThe broccoli-postcss plugin runs your `css` through postcss plugins of your choosing.\n\n## Installation\n\n```shell\nnpm install --save-dev broccoli-postcss\n```\n\n## Usage\n\n```javascript\nconst compileCSS = require('broccoli-postcss')\nconst outputTree = compileCSS(tree, options)\n```\n\n## Compatibility\n\nDue to changes in the plugin API of Postcss V8 some plugins will need to be updated after upgrading Postcss. This should be as simple as updating this package from V5 to V6, however compatibility is not guaranteed.\n\n- V6 broccoli-postcss -\u003e Postcss V8\n- V5 broccoli-postcss -\u003e Postcss V7\n\n## API\n\n### broccoliPostcss(tree, [options])\n\n#### options\n\n##### plugins\n\nType: `array`\n\nA list of plugin objects to be used by Postcss (a minimum of 1 plugin is required).\n\nThere are two supported methods for defining plugins:\n\n1. Object form\n\n    ```javascript\n    plugins: [\n      {\n        module: require('some-plugin'),\n        options: { /* options for `some-plugin` */ }\n      }\n    ]\n    ```\n\n2. Function form\n\n    ```javascript\n    plugins: [\n      require('some-plugin')({ /* options for `some-plugin` */ })\n    ]\n    ```\n\nNote: additional options (defined below) that are merged with the individual plugin options are *only* supported for plugins defined in \"object form\".\n\n#### browsers\n\nType: `array`\n\nA list of browsers to support. Follows the [browserslist](https://github.com/ai/browserslist) format. Will be passed to each plugin and can be overridden using the plugin’s options.\n\n##### map\n\nType: `object`\nDefault: `{ inline: false, annotation: false }`\n\nAn object of options to describe how Postcss should [handle source maps](https://github.com/postcss/postcss/blob/master/docs/source-maps.md).\n\n##### include\n\nType: `array`\nDefault: `[]`\n\nArray of GlobStrings|RegExps|Functions to describe a whitelist of files to get processed by Postcss.\n\n##### exclude\n\nType: `array`\nDefault: `[]`\n\nArray of GlobStrings|RegExps|Functions to describe a blacklist of files to be ignored by Postcss.\n\n\n## Example\n\n```javascript\n/* Brocfile.js */\nvar compileCSS = require('broccoli-postcss')\nvar cssnext = require('postcss-cssnext')\n\nvar options =  {\n  plugins: [\n    {\n      module: cssnext,\n      options: {\n          browsers: ['last 2 version']\n      }\n    },\n  ],\n  map: false,\n  include: ['styles/*.css'],\n  exclude: ['vendor/bootstrap/**/*']\n}\n\nvar outputTree = compileCSS('app/styles', options)\nmodule.exports = outputTree\n```\n\n[build-img]: https://github.com/jeffjewiss/broccoli-postcss/workflows/CI/badge.svg\n[build-url]: https://github.com/jeffjewiss/broccoli-postcss/actions?query=workflow%3ACI\n[npm-img]: https://badge.fury.io/js/broccoli-postcss.svg\n[npm-url]: https://www.npmjs.com/package/broccoli-postcss\n[monthly-downloads-img]: https://img.shields.io/npm/dm/broccoli-postcss.svg\n[monthly-downloads-url]: https://www.npmjs.com/package/broccoli-postcss\n[total-downloads-img]: https://img.shields.io/npm/dt/broccoli-postcss.svg\n[total-downloads-url]: https://www.npmjs.com/package/broccoli-postcss\n[coveralls-img]: https://coveralls.io/repos/github/jeffjewiss/broccoli-postcss/badge.svg?branch=master\n[coveralls-url]: https://coveralls.io/github/jeffjewiss/broccoli-postcss?branch=master\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeffjewiss%2Fbroccoli-postcss","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjeffjewiss%2Fbroccoli-postcss","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeffjewiss%2Fbroccoli-postcss/lists"}