Polymer: Simplify Travis builds with webcomponents.org

The webcomponents.org catalog obsoletes the creation of Github pages for Polymer documentation and demos.

Ronny Roeller
NEXT Engineering
2 min readJun 13, 2017

--

Polymer makes creating reusable elements a piece of cake. In fact, its modular nature enabled us to open source many of our generic elements on Github. Best of all, Polymer provides many helpers to automatically generate decent documentation and demos, thereby making the elements consumable for colleagues and the wider community.

Yet, one part of building open source Polymer elements used to be a real pain: the required scripting to create the Github pages for documentation and demos (see this blog post).

Good news: The webcomponents.org catalog obsoletes this step! After publishing an element to the catalog, it creates an element showcase page with the documentation and the demo. On top of it, the showcase page offers inline demoing: Users can edit demo code within the page, and directly see how the element behaves!

All you need to do is adding the following code to your README.md file on Github:

And as you’re on the README.md, you might also add the badge to let users find the showcase page:

Happy coding!

Want to learn more about Polymer? Have a look to all our Medium posts on Polymer.

Photo: Screenshot of webcomponents.org

--

--

Ronny Roeller
NEXT Engineering

CTO at nextapp.co # Product discovery platform for high performing teams that bring their customers into every decision