Polymer Logo Home Guides Feature overview Try Polymer Tutorial: Build an element 1. Get set up 2. Add local DOM 3. Data binding & properties 4. React to input 5. Theming with custom properties Define elements Register an element Declare properties Instance methods Behaviors Local DOM & styling Local DOM Styling Events Handle and fire events Gesture events Data system Data system concepts Work with object and array data Observers and computed properties Data binding Helper elements Tools Tools overview Polymer CLI Document your elements Test your elements Optimize for production Publish an element Advanced tools Services What's new Release notes 1.0 Migration guide About Polymer 1.0 Build apps Overview App templates Responsive app layout Routing Localization App storage Service worker Serve your app Resources Global settings Browser compatibility API API Reference Polymer.Base array-selector custom-style dom-bind dom-if dom-repeat dom-template Polymer.Templatizer

The Polymer library is in maintenance mode. For new development, we recommend Lit.

You're viewing an older version of the Polymer library documentation. Please see Polymer 3.0 for the latest.

Contents

You can get started with the Polymer App Toolbox using one of several templates that incorporate the elements and patterns discussed here using the Polymer CLI.

To initialize a project from a template, ensure you have the Polymer CLI installed, cd into an empty project folder, and simply run the following command, which will prompt you to select from the currently available templates.

    $ polymer init

The application template is the most basic starting point for any app built with Polymer. It starts with a single bare-bones custom element that can serve as the root of your application, from which you can build in any direction with maximum flexibility.

The starter-kit introduces the app-layout elements, and composes them in a common left-hand drawer arrangement with a toolbar. The template provides navigation between a series of views that load and are rendered in the main content area.

The template is also set up to use the PRPL pattern for efficient and progressive loading of the application, where views are loaded on-demand and will be pre-cached for offline and subsequent use.

The shop template is a full-fledged application that builds on the starter-kit and implements a series of elements that compose into a complete e-commerce application. It demonstrates a typical "home - list - detail" type of application flow, and can serve as inspiration or a starting point for a complete application.

The news template is a full-fledged application that builds on the starter-kit and implements a series of elements that compose into a complete news progressive web app. It demonstrates loading news items, and can serve as inspiration or a starting point for a complete application.

For implementation details, see the News case study. For information on using or customizing the news template, see the News documentation site.

The templates are starting points, and you are free to add web components discussed in the rest of the Polymer App Toolbox documentation according to the needs of your application, as well as from other sources such as the Polymer Element Catalog.