generator-polymer-init-twc-starter-kit
Generator for Polymer 2.0 application with navigation and PRPL pattern loading using Typescript and TWC
TWC (Typed Web Components - see Draccoz/twc for details) allows developers to use Typescript and decorators to create Polymer custom elements. TWC acts as a compiler, translating the Typescript into Polymer ES6 class based elements. There is no runtime library - everything happens in the build step.
This generator is based on the Polymer init starter kit generator, of course.
Install
First ensure you have the Polymer CLI installed. If not use:
npm i -g polymer-cli
Then install this package:
npm i -g generator-polymer-init-twc-starter-kit
Use
Create a new folder for your Polymer 2.0 project, cd into that folder and run polymer init:
mkdir a-new-app-name
cd a-new-app-name
polymer init
Choose the twc-starter-kit option from the list.
Generate Type Definitions for Polymer Elements Installed in Bower
This generator installs a number of Polymer elements via Bower. If you want to work with these in code it would be helpful to have type definitions for them. Fortunately, potts (polymer to typescript - Draccoz/potts), also by the author of twc is available to generate types for all Polymer elements in bower.json. See the working with types in the twc wiki for more details.
potts is installed as a dev dependency by this generator and a script tag is included to run it. In your project root enter:
npm run potts
This will create a file potts.d.ts that contains basic type definitions for Polymer elements installed as bower dependencies.
Compile Typescript
Compile typescript classes to ES6 class based Polymer 2.0 dom modules by running the twc command from the project's root folder.
Serve Your App
polymer serve
Review the TWC Wiki
Documentation on TWC can be found in the Draccoz/twc Wiki.
Issues
Please submit issues regarding this generator through github at mlisook generator-polymer-init-twc-starter-kit issues.
Contributions
Contributions are welcome and appreciated.
License
MIT