Inferno+Mobx starter project
JavaScript CSS
Latest commit 2b34d2b Jan 15, 2017 @nightwolfz committed on GitHub Merge pull request #20 from JohnRSim/master
update router index path
Failed to load latest commit information.
core Fix rejected promise handling Jan 7, 2017
src update router index path Jan 13, 2017
.babelrc Fix issues Nov 16, 2016
.eslintrc.json Bump inferno versions Jan 2, 2017
LICENSE Updated README Jan 5, 2017
index.js Update to webpack 2 RC Dec 30, 2016
nodemon.json Update to webpack 2 RC Dec 30, 2016
package.json Updated packages and fixed bug #17 Jan 10, 2017
preview.png Initial commit Aug 4, 2016

Inferno + Mobx Starter project



The goal of this project is to provide a starting base for an mobx inferno project with isomorphism.


  • async/await support
  • Isomorphic for SEO goodness
  • CSS and SCSS compilation
  • MongoDB user register/login/logout
  • Token based authentication
  • Decorators for accessing actions and state
  • Hot reload
  • Bundle size as small as possible
  • Offline support through service workers


How to run

For development:

npm run dev

For production:

npm run prod


Node 6+ (or Node 4 with additional babel plugins)
MongoDB server


  • Optimized for minimal bundle size.
  • Optimized for server-side speed. (See the benchmark, it's fast !)
  • Using Inferno, the fastest React-like framework out there.
  • Using MobX, the easiest and insanely fast state manager.
  • Simple and minimal with routing, authentication, database and server-side rendering.
  • Good developer experience with hot-reloading and source-maps.
  • Get to 100% score on Google Lighthouse


gb -G=4 -k=true -c 200 -n 10000 http://localhost:2000/about

Document Path:          /about
Document Length:        1436 bytes

Concurrency Level:      200
Time taken for tests:   3.06 seconds
Complete requests:      10000
Failed requests:        0
HTML transferred:       14360000 bytes
Requests per second:    3262.76 [#/sec] (mean)
Time per request:       61.298 [ms] (mean)
Time per request:       0.306 [ms] (mean, across all concurrent requests)
HTML Transfer rate:     4575.37 [Kbytes/sec] received

Connection Times (ms)
              min       mean[+/-sd]     median  max
Total:        1         0   12.07       59      246

Tested on i7-6700K @ 4.00GHz 16GB RAM. Single node.js instance.


What are stores ?

Stores will contain the state of your application and the methods that mutate that state. Basically most of your client side logic is inside stores.

What is connect ?

The @connect decorator injects stores into your components. Additionally, it keeps your components up to date with any changes in your stores.

Example: If you display a messageCount from a Messages store and it gets updated, then all the visible components that display that messageCount will update themselves.

Does connecting many components make my app slower?

No, it actually allows the rendering to be done more efficiently. So connect as many as you want !

Adding mongoose models

  1. Goto src/server/models
  2. Add [Name].js with your model in it

Adding stores

  1. Goto src/client/stores
  2. Add [name].js (based on another store like account.js)
  3. Update src/client/stores.js

Enabling server-side rendering

  1. Goto src/server/config
  2. Set server.SSR variable to true or false

My components are not updating!

Make sure you added the @connect decorator to your component.

My stateless component doesn't have access to the stores !

You cannot use decorators on stateless components. You should instead wrap your component like this:

const MyComponent = connect((props, context) => {
  return <p>{context.state.something} !</p>

How do I execute async actions on the server and/or client ?

Add a static onEnter method to your component like this:

class MyComponent extends Component {
    static onEnter({ myStore, params }) {
        return myStore.browse()
    // ...

The onEnter method is smart, it will be executed either on the server or on the browser depending on how you access the website.

It also passes all your stores and url params as arguments as a convenience.

Useful links




Ryan Megidov