Yeoman Generator
for Custom Elements

A Yeoman Generator that provides a functional boilerplate to easily create Custom Elements using Polymer, X-Tag or VanillaJS.

All templates are based in the boilerplates authored by the WebComponents.org team:

• Polymer Boilerplate
• X-Tag Boilerplate
• VanillaJS Boilerplate

Install

Install this generator using NPM:

1

$ [sudo] npm install -g generator-element

Getting Started

There are two different generators available.

• The first one used to scaffold out new individual elements:

  1	$ yo element

  1 2 3

  [?] What do you want to use? [?] What's the name of your element? [?] Do you want to include lifecycle callbacks?

  Which will generate the following file:

  1 2	. └── my-element.html

• The second one is used to scaffold an entire project:

  1	$ yo element:repo

  1 2 3 4 5 6 7

  [?] What do you want to use? [?] What's the GitHub repository? [?] What's your GitHub username? [?] What's the name of your element? [?] How would you describe the element? [?] Do you want to include lifecycle callbacks? [?] Do you want to include some useful Grunt tasks?

  Which will generate the following project structure:

  1 2 3 4 5 6 7 8

  . ├── .editorconfig ├── .gitignore ├── bower.json ├── package.json ├── index.html ├── Gruntfile.js └── src/my-element.html

  And run bower install & npm install for you to fetch all dependencies.

Note: files will be generated in the current directory, so be sure to change to a new directory before running those commands if you don't want to overwrite existing files.

Contributing

1. Fork it!
2. Create your feature branch: git checkout -b my-new-feature
3. Commit your changes: git commit -m 'Add some feature'
4. Push to the branch: git push origin my-new-feature
5. Submit a pull request :D

History

For detailed changelog, see Releases.

Team

This project is maintained by these people and a bunch of awesome contributors.

Zeno Rocha	Addy Osmani

License

MIT License © WebComponents.org