/yo

CLI tool for running Yeoman generators

Primary LanguageJavaScriptBSD 2-Clause "Simplified" LicenseBSD-2-Clause

yo npm Build Status Coverage Status Gitter OpenCollective

What's Yeoman?

Yeoman helps you to kickstart new projects, prescribing best practices and tools to help you stay productive.

To do so, we provide a generator ecosystem. A generator is basically a plugin that can be run with the yo command to scaffold complete projects or useful parts.

Usage

# install yo
npm install --global yo

# install a generator
npm install --global generator-webapp

# run it
yo webapp

or via brew:

brew install yo

To create and distribute your own generator, refer to our official documentation

You can also run a local generator on your computer as such:

# Running a local generator
yo ./path/to/local/generator

Options

  • --no-color - Disable colors.
  • --version - Print the current yo version.
  • --help - Print yo help menu with the list of found generators.
  • --generators - Print available generators.
  • --local-only - Disable lookup of globally-installed generators.

Troubleshooting

Running yo doctor command can help you troubleshoot common issues.

If doctor doesn't help, then check opened issues for a similar problem. Open a new issue if your problem haven't been reported yet. Make sure to always include the version of yo (yo --version) and Node.js (node --version) you use.

If your issue only occurs using a generator, please report the issues on the generator's repository.

Contribute

See the contributing docs.

Changelog

See the release page.

Backers

Love Yeoman work and community? Help us keep it alive by donating funds to cover project expenses!
[Become a backer]

License

BSD-2-Clause © Google