generator-polymer-init-twc-starter-kit

    0.1.0 • Public • Published

    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

    Install

    npm i generator-polymer-init-twc-starter-kit

    DownloadsWeekly Downloads

    0

    Version

    0.1.0

    License

    MIT

    Last publish

    Collaborators

    • mlisook