Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/deprecate/generator-element
Yeoman generator to create Custom Elements using Polymer, X-Tag or VanillaJS
https://github.com/deprecate/generator-element
Last synced: about 2 months ago
JSON representation
Yeoman generator to create Custom Elements using Polymer, X-Tag or VanillaJS
- Host: GitHub
- URL: https://github.com/deprecate/generator-element
- Owner: deprecate
- Created: 2014-02-21T13:10:51.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2021-12-31T16:14:23.000Z (over 2 years ago)
- Last Synced: 2024-05-08T04:01:49.755Z (about 2 months ago)
- Language: JavaScript
- Homepage: https://npmjs.org/generator-element
- Size: 69.3 KB
- Stars: 129
- Watchers: 10
- Forks: 18
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Lists
- awesome-webcomponents - Element Generator for Yeoman
README
# Yeoman Generator
for Custom Elements[![NPM version](http://img.shields.io/npm/v/generator-element.svg?style=flat)](http://npmjs.org/generator-element)
[![NPM downloads](http://img.shields.io/npm/dm/generator-element.svg?style=flat)](http://npmjs.org/generator-element)
[![Build Status](http://img.shields.io/travis/webcomponents/generator-element/master.svg?style=flat)](https://travis-ci.org/webcomponents/generator-element)
[![Dependency Status](http://img.shields.io/david/webcomponents/generator-element.svg?style=flat)](https://david-dm.org/webcomponents/generator-element)![WC + Yeoman](https://cloud.githubusercontent.com/assets/398893/3528278/c3c2eae6-078d-11e4-88c5-7a853d7a5757.jpg)
> A Yeoman Generator that provides a functional boilerplate to easily create Custom Elements using [Polymer](http://www.polymer-project.org/), [X-Tag](http://x-tags.org/) or [VanillaJS](http://vanilla-js.com/).
> All templates are based in the boilerplates authored by the [WebComponents.org team](https://github.com/webcomponents/):
> * [Polymer Boilerplate](https://github.com/webcomponents/polymer-boilerplate)
> * [X-Tag Boilerplate](https://github.com/webcomponents/x-tag-boilerplate)
> * [VanillaJS Boilerplate](https://github.com/webcomponents/element-boilerplate)## Install
Install this generator using NPM:
```sh
[sudo] npm install -g generator-element
```## Getting Started
![ScreenShot](https://cloud.githubusercontent.com/assets/398893/3528261/a8bdefb6-078d-11e4-900d-b6d4df3ead79.png)
There are two different generators available.
* The first one used to scaffold out new **individual elements**:
```sh
yo element
``````
[?] 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:
```
.
└── my-element.html
```* The second one is used to scaffold an **entire project**:
```sh
yo element:repo
``````
[?] 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:
```
.
├── .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](https://github.com/webcomponents/generator-element/releases).
## Team
This project is maintained by these people and a bunch of awesome [contributors](https://github.com/webcomponents/generator-element/graphs/contributors).
[![Zeno Rocha](https://2.gravatar.com/avatar/e190023b66e2b8aa73a842b106920c93)](https://github.com/zenorocha) | [![Addy Rocha](https://2.gravatar.com/avatar/96270e4c3e5e9806cf7245475c00b275)](https://github.com/addyosmani)
--- | --- | --- | --- | ---
[Zeno Rocha](https://github.com/zenorocha) | [Addy Osmani](https://github.com/addyosmani)## License
[MIT License](http://webcomponentsorg.mit-license.org/) © WebComponents.org