Have opinions about JavaScript? We want to hear them. Take the 2018 JavaScript Ecosystem Survey »


3.13.2 • Public • Published

Riot logo

Simple and elegant component-based UI library

Build Status MIT License Riot Forum Join the chat at https://gitter.im/riot/riot Join the chat (ja) at https://riot-jp-slackin.herokuapp.com/ OpenCollective Backers OpenCollective Sponsors

NPM version NPM downloads jsDelivr Hits Coverage Status Riot Size Code Quality

Sauce Test Status

Framework Size Comparison

Framework Version Minified Size (gzip)
@angular/core + Polyfills 7.0.0 314.18kb
Ember 2.18.2 121.84kb
Polymer + Web Components Polyfill Lite 1.8.0 66.3kb
Polymer + webcomponents-loader.js + webcomponents-bundle.js 3.0.0 45.70kb
React + Map and Set Polyfills 16.5.2 44.75kb
Web Components Polyfill 0.7.24 33.68kb
Vue 2.5.17 31.65kb
Riot 3.13.2 10.85kb
Inferno 6.0.0 7.65kb
Preact 8.3.1 3.48kb

The above comparison includes polyfills to support old browsers like IE9 that in Riot.js are supported by default.

Browsers support

Riot is supported by all modern browsers and it does not require any additional polyfill

  • IE 9+
  • Edge
  • Chrome
  • Safari 7+
  • Firefox
  • Safari iOS
  • Android

Custom tags • Concise syntax • Simple API • Tiny Size

Riot brings custom tags to all modern browsers. Think React + Polymer but with enjoyable syntax and a small learning curve.

Tag definition

  <p>Seconds Elapsed: { time }</p>
  this.time = opts.start || 0
  tick() {
    this.update({ time: ++this.time })
  var timer = setInterval(this.tick, 1000)
  this.on('unmount', function() {

Open this example on Plunker


riot.mount('timer', { start: 0 })


Custom tags lets you build complex views with HTML.

  <timer start="0"></timer>
  <timer start="10"></timer>
  <timer start="20"></timer>

HTML syntax is the de facto language on the web and it's designed for building user interfaces. The syntax is explicit, nesting is inherent to the language and attributes offer a clean way to provide options for custom tags.

Expressions Bindings

  • Absolutely the smallest possible amount of DOM updates and reflows.
  • One way data flow: updates and unmounts are propagated downwards from parent to children.
  • Expressions are pre-compiled and cached for high performance.
  • Lifecycle events for more control.

Close to standards

  • No proprietary event system.
  • Event normalization.
  • The rendered DOM can be freely manipulated with other tools.
  • No extra HTML root elements or data- attributes.
  • Plays well with any frontend framework.

Use your dearest language and tools

Note: * officially maintained

CDN hosting

Concise syntax

  • Power shortcuts: class={ enabled: is_enabled, hidden: hasErrors() }.
  • No extra brain load such as render, state, or constructor.
  • Interpolation: Add #{ items.length + 1 } or class="item { selected: flag }"
  • Compact ES6 method syntax.




Video Tutorials

Libraries / Frameworks





Editors / Editor Plugins (Syntax highlighting, autcompletion, etc...)

How to contribute

If you are reading this it's already a good sign and we are thankful for it! We try our best working as much as we could on riot but your help is always appreciated.

If you want to contribute to riot helping us maintaining the project please check first the list of our open issues to understand whether there is a task where you could help.

Riot is mainly developed on UNIX systems so you will be able to run all the commands necessary to build and test the library using our Makefile. If you are on a Microsoft machine it could be harder to set up you development environment properly.

Following the steps below you should be able to properly submit your patch to the project

1) Clone the repo and browse to the riot folder

$ git clone git@github.com:riot/riot.git && cd riot

2) Set up your git branch

$ git checkout -b feature/my-awesome-patch

3) Install the npm dependencies

$ npm i

4) Build and test riot using the Makefile

# To build and test riot 
$ make riot
# To build without testing 
$ make raw
# To build anytime you change a src file 
$ make watch
# To bench riot 
$ make perf

5) Pull request only against the dev branch making sure you have read our pull request template

6) Be patient


Riot is made with ❤️ by many smart people from all over the world. Thanks to all the contributors
It's actively maintained by:

Gianluca Guarini

Official Website



Support us with a monthly donation and help us continue our activities. Become a backer



Become a sponsor to get your logo on our README. Become a sponsor



Special thanks to Browserstack for their support

browser stack


npm i riot

Downloadsweekly downloads










last publish


  • avatar
Report a vulnerability