The definitive source of the best
JavaScript libraries, frameworks, and plugins.

  • ×

    A Web Component compiler for building fast, reusable UI components and Progressive Web Apps 馃拵 Built by the Ionic Framework team
    Filed under 

    • 🔾83%Overall
    • 12,287
    • 7 hours
    • 🕩760
    • 👥8



    A compiler for generating Web Components using technologies like TypeScript and JSX, built by the Ionic team.

    StencilJS is released under the MIT license. StencilJS is released under the MIT license. PRs welcome! Follow @stenciljs Official Ionic Discord

    Quick Start Documentation Contribute Blog
    Community: Discord Forums Twitter

    Getting Started

    Start a new project by following our quick Getting Started guide. We would love to hear from you! If you have any feedback or run into issues using Stencil, please file an issue on this repository.


    A Stencil component looks a lot like a class-based React component, with the addition of TypeScript decorators:

    import { Component, Prop, h } from '@stencil/core';
      tag: 'my-component',            // the name of the component's custom HTML tag
      styleUrl: 'my-component.css',   // css styles to apply to the component
      shadow: true,                   // this component uses the ShadowDOM
    export class MyComponent {
      // The component accepts two arguments:
      @Prop() first: string;
      @Prop() last: string;
       //The following HTML is rendered when our component is used
      render() {
        return (
            Hello, my name is {this.first} {this.last}

    The component above can be used like any other HTML element:

    <my-component first="Stencil" last="JS"></my-component>

    Since Stencil generates web components, they work in any major framework or with no framework at all. In many cases, Stencil can be used as a drop in replacement for traditional frontend framework, though using it as such is certainly not required.


    Thanks for your interest in contributing! Please take a moment to read up on our guidelines for contributing. Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

    Show All