<< Back
Isomorphic React/Preact with Heroku

Rugby News Board is the side project mentioned in title, which is a simple news site for Rugby sport in Chinese. I made it because there is no Rugby news site in Chinese and I love Rugby.

Rugby News Board was firstly built with Rails, with simple news channels. By Rails, I could be able to make prototype within 2 days. I wrote a news table with ORM and SQLite. It ran on Linode VPS and I did DevOps by myself.


Since I read about the article from Unsplash Scaling Unsplash with a small team, I realized that I should emigrate from VPS to PaaS to avoid unnecessary cost for infrastructures. I have kept on evaluating containers and other technology on the VPS but it was neither profitable nor productive to the project.

As a result, I started to migrate to Heroku, as I sought for more efficiency, reliability and convenience. The process didn’t take too much effort. The only major change to my Rails app is that the database was changed into Postgres.

Isomorphic JavaScript

Rails is flexible both backend and frontend, with components support for everything, and it is a perfect MVC framework for multiple pages application. However, MVVM is the future, e.g. React. It is a bit more reasonable, elegant and expressive way to make data reactive than modify DOM with jQuery. Moreover, I just want to keep on track with modern frontend development.

By the way, I feel quite strange using CoffeeScript, as part of Rails stacks. Being surrounded by Vanilla JavaScript, EcmaScript of all versions, and TypeScript, I have no interest in learning an unpopular JavaScript replacement, which some dudes said it was dead.

I tried using React with react-rails to build translating system of Rugby names. It is merely based on Rails, and we can use React Component with react_component tag and simply pass the data (Ruby objects) to the component seamlessly.

<div class="section-item">
  <%= react_component "RugbyDictQuery", {title: "Rugby Dictionary"} %>

react-rails is a great binding between Rails and React. But the trend is isomorphic React application as frontend and backends serve only APIs. I read some articles and slides from companies use both Rails and React, such as The Evolution of Airbnb’s Frontend and Scaling Unsplash with a small team again.

They both prefered build isomorphic JavaScript application with Node and React. I followed Unsplash, because we use the same PaaS and frameworks.

React App

Initially, I setup my project with JavaScript Stack from Scratch. I won’t post many codes here, since it is routine work with React. The only unfortunate thing is that I forgot to use ESLint from start. In consequence, I had to spend hours fixing 200+ issues.

However, Webpack is just like a blackbox and I have to do a lot of work to get it done. What I need to do was to specify my entries and outputs with various kinds of loaders and plugins.

Webpack with Multiple Entries

Examples and boilerplates are typically in one HTML form. However, there are two pages in my application. One is index.html for user requests, the other is admin.html for editors. Both of them should be equipped with HMR (Hot Module Replacement).

This article is great as the title Truly Multiple Entries with Webpack says.

const path = require('path');
const webpack = require('webpack');
const HtmlWebpackPlugin = require('html-webpack-plugin');

module.exports = {
  entry: {
    index: [
    admin: [
  module: {
    // loaders ...
  resolve: {
    extensions: ['.js', '.jsx'],
  output: {
    path: path.resolve(__dirname, '..', 'dist'),
    filename: '[name]/bundle.js',
    publicPath: '/',
  plugins: [
    new HtmlWebpackPlugin({
      template: './client/index.html',
      filename: 'index.html',
      inject: 'body',
      chunks: ['index'],
      hash: true,
    new HtmlWebpackPlugin({
      template: './client/admin.html',
      filename: 'admin.html',
      inject: 'body',
      chunks: ['admin'],
      hash: true,
    new webpack.HotModuleReplacementPlugin(),
    new webpack.NoEmitOnErrorsPlugin(),
  devServer: {
    historyApiFallback: true,

Dev Server

To get good developer experience, it is important to setup a realtime debugging environment for development. I was prepared to setup dev server for my isomorphic app with webpack-dev-middleware and webpack-hot-middleware.

const webpack = require('webpack');
const webpackConfig = require('../config/');
const compiler = webpack(webpackConfig);
const webpackDevMiddleware = require('webpack-dev-middleware');
const webpackHotMiddleware = require('webpack-hot-middleware');
// Dev
app.use(webpackDevMiddleware(compiler, {
  noInfo: true,
  publicPath: webpackConfig.output.publicPath,
// HMR
app.use(webpackHotMiddleware(compiler, {
  log: console.log,
  path: '/__webpack_hmr',
  heartbeat: 10 * 1000,

However, things became complex with multiple pages. It seemed that webpack-dev-middleware never actually build files into output path.

The index.html was always accessbile, while the other page - admin.html was possibly in some black hole. I resolved it by serve the files from the compiler.

app.get('/admin', (req, res) => {
  const filename = path.join(compiler.outputPath, 'admin.html');
  compiler.outputFileSystem.readFile(filename, (err, result) => {
    res.set('content-type', 'text/html');

In the end, I managed to make it work that I can simply start to dev by one command yarn server, with a Node server, a React app and HMR.

Build after Deployment

Deployment on Heroku is easy, but I had to commit dist folder to codebase at first, which was really a heavy way (hundreds of kilobytes each push). Then I found heroku-postbuild hook, by which deployment can trigger Webpack build.

So let’s add heroku-postbuild to package.json:

"heroku-postbuild": "webpack -p --config ./config/"

Hint: We should ensure that the build process works before pushing codes. Otherwise, deployment fails.

Optimizing and Preact

After the launch of new Node/React application, I could hardly ignore the long gap between the response reached and I saw the page finally. Heroku is commonly laggy in China due to geolocation reason and the great firewall. I put it down to this reason until I found the bundle.js is 1.8 mb.

The reason is that the Webpack production configuration was wrong, I fixed it by adding UglifyJsPlugin and it is now 700 kb.

plugins: [
  new webpack.NoEmitOnErrorsPlugin(),
  new webpack.DefinePlugin({ 'process.env.NODE_ENV': '"production"' }),
  new webpack.optimize.OccurrenceOrderPlugin(),
  new webpack.optimize.UglifyJsPlugin({
    compress: {
      screw_ie8: true,
      warnings: false,
    mangle: {
      screw_ie8: true,
    output: {
      comments: false,
      screw_ie8: true,

Even 700 kb is a considerably large size. And then I came up with an idea of using Preact, “Fast 3kb React alternative with the same ES6 API”, which is confirmed by my frontend expert friend @yanni4night.

I had no many codes so I use Preact directly, without using preact-compat to make it compatible with React.

import { h, Component } from 'preact';

It goes as soon as I change the import statements on the top.

react-router was replaced by preact-router, which is even more user-friendly. The parameters are simply passed to props:


<EventPage path="/event/:name" />

EventPage Component:

export default class EventPage extends Component {
  constructor(props) {

    this.state = {
      pageNum: || 0,

After the optimization, it is only 364 kb and typically takes less than 2 seconds to load the application. Using Preact is a good choice, while we can get the advantage of React and benefit from the lightweight.

At last, DO NOT forget to turn on gzip of your Express server or other static file server like Nginx. That dramatically cuts the bundle size to 1/4, which is less than 100kb now.


The development experience of frontend is great, with fancy frameworks, tools and developer’s ecology. It evolves very fast, faster than evolvement of its documentation. The examples of the documentations fail frequently as version increases fast. But, it’s fantastic that they often give accurate migration advice so that I can fix immediately. For other problems, StackOverflow provides strong supports as frontend people are the most vigorous in the industry.