Polymer is a library of polyfills and sugar which enable the use of Web Components in modern browsers. The project allows developers to build apps using the platform of tomorrow and inform the W3C of places where in-flight specifications can be further improved.
generator-polymer provides Polymer scaffolding using Yeoman (a scaffolding tool for the web), letting you easily create and customize Polymer (custom) elements via the command-line and import them using HTML Imports. This saves you time writing boilerplate code so you can start writing up the logic to your components straight away.
- A Polymer app scaffold built with HTML5 Boilerplate
- Sub-generator to create Polymer elements for your app
- Boilerplate to create reusable Polymer elements
- Quick deploy to GitHub pages
- All the goodness of
seed-element(docs & landing page for your element)
Install the generator
npm install -g generator-polymer
Make a new directory and cd into it
mkdir -p my-project && cd $_
Scaffold a new Polymer project:
yo polymer
Available generators:
Note: Generators are to be run from the root of your app
Sets up a new Polymer app, generating all the boilerplate you need to get started.
Example:
yo polymerGenerates a polymer element in app/elements and appends an import to app/elements/elements.html.
Example:
yo polymer:el my-elementNote: You must pass in an element name, and the name must contain a dash "-"
Generates a reusable polymer element based on the seed-element workflow. This should only be used if you're creating a standalone element repo that you intend to share with others via bower. If you're just building a Polymer app, stick to the El generator.
To create a seed-element you'll first need to create a parent directory, then a sub directory to hold your seed-element. All bower dependencies will be installed into the parent directory. Please follow the seed-element guide for more instructions.
Example:
mkdir -p components/x-foo && cd $_
yo polymer:seedGenerates a Github pages branch for your seed-element.
Example:
cd components/x-foo
yo polymer:ghSee the contributing docs
When submitting an issue, please follow the guidelines. Especially important is to make sure Yeoman is up-to-date, and providing the command or commands that cause the issue.