Building Apps with Riot, ES6 and Webpack

Tue Feb 10, 2015

I arrived at Riot after reading the Muut Frameworkless JavaScript blog post – read this first! The Muut programmers have put their money where their mouths are and built Riot, a minimalist Reactjs-like library called Riot for building reactive UI components.

Reading the Riot documentation the thing that struck me was how easy Riot is to understand – there are very few new terms and concepts to learn compared to React (which, to be fair, is also straight-forward compared to e.g. Polymer and Angular).

To help me learn Riot I ported my React Flux Backbone Todos Example to a Riot Todo app. This post is a compilation of notes I made documenting the experience.

The tl;dr answers are:

  1. Riot really does live up to its minimalist motto. The (unminified) Riot version of the Todo weighs in at a tiny 32KB compared to 964KB for the React version (600KB after subtracting Backbone and JQuery which are not used in the Riot version). However you look at it that’s a huge difference.

  2. Riot has that rare Goldilocks “just right” feel about it and is a joy to use.

  3. Riot is a relatively new project, I was unable to find statistics on how it scales performance-wise in larger projects. How it fares alongside the Rect juggernaut is an open question – I hope it does well.

If you’re not familiar with Riot take a look at the Riot website – the documentation is first class. So rather than discussing how Riot works I’ll just list things I’ve learnt that may not be obvious reading the documentation.

Using ES6 with Riot

The example app is written in ES6, I use the 6to5 transpiler to convert it to ES5 and Webpack to bundle the compiled code along with required libraries. This approach necessitates combining JavaScript modules – working in ES6 is particularly nice as you get to take advantage of the new ES6 import and export statements (see this example).

Webpack is configured to use the 6to5-loader which automatically converts ES6 source to CommonJS formatted ES5 modules that are then bundled into the single bundle.js distributable file.

Why I don’t use Riot .tag files

Riot tag files are HTML templates containing HTML markup along with JavaScript UI logic. If you’ve looked at the Todo app app you are probably wondering where the tag files are – the answer is that I no longer use them, preferring JavaScript instead. By eliminating .tag files I’ve simplified my coding, tooling and workflow. For me, tag file complexity and limitations outweigh any perceived benefits.

This is not a criticism of Riot, the neat thing about tag files is that they’re entirely optional and I’m documenting why I don’t use them.

When you examine the compiled JavaScript you see that Riot tag files are a thin layer of syntactic sugar.

  • They add an additional conceptual layer – new(ish) syntax and semantics have to be learned.

  • They add an additional compilation step.

  • The tag file compiler dictates the languages and templates you can use (CoffeeScript, ES6, Jade) contradicting the “Use your favorite tools” mantra.

  • The tag constructor-body logic is out of context:

    • It is not amenable to editor/IDE linting and other tooling.
    • Referencing this out of context means the code is not legal JavaScript and generates errors in editors/IDEs.
  • There is currently no support for module formats (CommonJS, AMD) – tag files compile to plain JavaScript .

  • Tag files require tag loaders to be used directly in build tools such as Webpack and Browserify.

  • The “ES6-like” constructor methods are nice but they are not legal JavaScript and are likely to always be a source of ongoing confusion (syntax and semantics). You can use ES6 arrow functions to achieve the same semantics (lexically bound this) with almost the same brevity, for example:

this.add = (e) => {
  var input =[0]
  input.value = ''

Here’s an example of an ES6 JavaScript tags file using ES6 template strings and arrow functions.

ES6 Template Strings aid the readability of tag HTML templates. Similarly, if you are using CoffeeScript you can use CoffeeScript Block Strings. JSX is another possibility – React’s JSX transformer could be modified to emit a string literal and you could then take advantage of existing JSX tooling support.

The fundamental difference between Riot and React

The most significant difference lies in how the UI markup templates are declared:

  • In React the UI template markup is baked in your JavaScript source (using the JSX language extension).
  • Riot inverts the React model by putting the markup and logic in an HTML (tag) file.

The upshot of this inversion is that the React template DSL language is JavaScript whereas Riot relies on a custom template DSL (implemented with custom tags). Here are two simplified examples that generate a list from an array of todo items: the first is React JavaScript the second is the equivalent Riot tag markup:

<ul> =>
    <li><TodoItemComponent todo={todo} /></li>)
  <li each="{todo in todos}">
    <todo-item todo="{todo}">

The first example uses JavaScript’s map function to generate a list of <li> elements; the second uses Riot’s custom each template attribute.

Steve Luscher explains why he thinks JavaScript is better than custom template DSLs towards the end of this video – not only do you have to learn a custom DSL you are also constrained by the features the DSL offers. For small common use-case examples like ones above there is little to choose between the two approaches, but when it comes to larger highly dynamic UI compositions the power and flexibility of React’s JavaScript approach is clearly superior.


Avoid self-closing XHTML style tags

Do not close tags with /> as it does not always immediately close the tag. When dealing with HTML5 elements <foo /> means <foo> (whereas in XHTML <foo /> means <foo></foo>) i.e. HTML5 ignores the / character. See this Stackoverflow post on the subject. See also:

Bind tag event handlers to this

Bind tag event handlers to this to ensure they are always fired with the tag context (alternatively use the var self = this idiom). For example:

this.clear = function(e) {

With ES6 you can achieve the same thing with lexically bound ES6 arrow functions:

this.clear = (e) => {

Referencing Loop items

Use the each="{item in items}" construct to pass the current looped item to a child custom tag. In the following example the code in the custom todo-item tag can refer to the current todo item with opts.todo:

 <li each="{todo in}">
   <todo-item store="{}" todo="{todo}">

Namespace event names

Use the colon namespacing convention to group application event names e.g. admin:edit, admin:delete, admin:new.

You can use custom tag names in CSS files

Custom tags are rendered into the DOM and so they can be used for CSS selection and DOM interrogation, here’s an example.


When bundling with Webpack you need to use the devtool source-map configuration option to produce a source map file for you bundled app. This allows you to debug from the ES6 source code files.

To browse and debug the source code open your browser’s Sources window and navigate to the folder webpack:///.:

  • In Firefox: open the Debugger (Ctrl+Shift+S).
  • In Google Chrome: open the Console (Ctrl+Shift+J) then click on the Sources tab to view the Sources panel.

I’m not big on debuggers and break points – most of the time I just put strategically placed temporary console.log() statements in the code.

The Big Picture

Riot (like React) is a UI library, not a framework. This is good (I prefer a small set of focused libraries to an all encompassing framework) but non-trivial applications need a coherent high-level structure (an architecture) to ease scalability, evolution and maintainability. Flux is increasing the architecture of choice for React-like apps. I like Flux because it’s easy to understand and because it makes intuitive sense (not out of any theoretical conviction). The Riot Todo app uses the RiotControl flux-style dispatcher (slightly modified) to implement the Flux architecture.

Next: »