Update
I now recommend using seed-element if you're starting off new Polymer elements. I wrote a guide on how to use it over on the Polymer docs site.
Polymer.js Boilerplate
Polymer Boilerplate is a front-end template for building fast, robust, and adaptable web apps using Web Components.
Introduction
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.
Features
- Boilerplate for Polymer elements
- Minimal HTML5 Boilerplate
- Vulcanize support for inlining HTML Imports
- LiveReload support for automatic refresh on edit
- JSHint linting for projects
- Mocha for unit testing
- Sane project stucture
- Simple sample Polymer elements
- Grunt for build-process, Bower for dep. management
- "Delete-key friendly." Easy to strip out parts you don't need.
Preview
Quick start
Using Bower
Run bower install polymer-boilerplate
With Git
Clone the git repo — git clone https://github.com/addyosmani/polymer-boilerplate.git
- and checkout the tagged
release you'd like to
use.
# Install our Grunt dependencies
$ cd polymer-boilerplate
$ npm install && bower install
# Edit and the browser live reloads
$ grunt server
# Build your project, creating an optimized build.html
$ grunt build
# Run any unit tests you might have written
$ grunt test
Contributing
Anyone and everyone is welcome to contribute.
Looking for Polymer.js tooling?
For a more interactive developer experience, we recommend using generator-polymer - Polymer scaffolding using Yeoman (a scaffolding tool for the web). This lets 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.