Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
October 21, 2021 20:07
November 12, 2021 23:16
December 9, 2018 08:30
August 9, 2020 21:15
October 21, 2021 13:58
October 21, 2021 13:58
October 21, 2021 20:07
October 21, 2021 13:58
October 21, 2021 13:58
October 21, 2021 20:09
October 21, 2021 20:09

PostCSS Plugin Boilerplate

Сreate new PostCSS plugins in a few steps:

  1. Execute the wizard script. It will ask you a few questions and fill all files with your data.

    npx postcss-plugin-boilerplate <directory>

    Call it with --npm argument, if you have yarn installed, but prefer to use npm as the package manager (by default, it will automatically decide whether to use yarn or npm):

    node postcss-plugin-boilerplate --npm <directory>

    Or use --no-install if you want to skip dependencies installation.

  2. Your plugin repository will now have a clean Git history. Create the GitHub repository and push your project there.

  3. Add your project to Travis CI.

  4. Write some code to index.js and tests to index.test.js.

  5. Execute npm test command

  6. Add input and output CSS examples to

  7. Add options descriptions if your plugin has them.

  8. Fill with initial version.

  9. Release by calling npx clean-publish (this tool will remove development configs from package.json).

  10. Fork PostCSS, add your plugin to the Plugins list and send a pull request.

  11. Follow @PostCSS to get the latest updates.