create-postcss-plugin

create-postcss-plugin

Create PostCSS Plugin lets you quickly create new PostCSS plugins with documentation, tests, and built in compiling for supported Node environments.

npm init postcss-plugin YOUR_DESTINATION

npx create-postcss-plugin YOUR_DESTINATION

After completing the instructions, write your plugin to src/index.js and update README.md with further details outlining your plugin functionality.

Options

You can pass options into postcss-plugin to automate plugin creation.

to

The to argument defines the destination of the new project. The first undefined argument will also determine this value.

npm init postcss-plugin --to path/to/plugin

title

The title argument defines the formal name of the project.

npm init postcss-plugin --title Super

npm init postcss-plugin --title "Awesome Blossom"

id

The id argument defines the id used by the project package.json and repository.

npm init postcss-plugin --id awes-blos

desc

The desc or description argument defines the description used by the project README.md and package.json.

# becomes "Use exciting new functions" and "Awesome Blossom lets you create new functions in CSS."
npm init postcss-plugin --desc "use exciting new functions"

# becomes "Use exciting new functions" and "Awesome Blossom lets you create new functions in CSS."
npm init postcss-plugin --description "use exciting new functions"

author

The author argument defines the author used by the project package.json.

npm init postcss-plugin --author "Joe Bloggs"

email

The email argument defines the email used by the project package.json.

npm init postcss-plugin --email "[e-mail]"

user

The user argument defines the repository user or group hosting the project.

npm init postcss-plugin --user "postcss"

keywords

The keywords argument defines the keywords used by the project package.json.

npm init postcss-plugin --keywords "awesome,blossom"

no-install

The no-install argument instructs the project to not automatically install dependencies.

npm init postcss-plugin --no-install

Changelog

2.0.0 (Jan 31, 2019)

• Added: Support for package description (pkgdesc)
• Updated: postcss to 7.0.14 (patch)