Node.js ES6 framework for reactive, data-driven apps and APIs (Koa, RethinkDB)
JavaScript CoffeeScript HTML CSS
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
bin create app folder if it doesn't exist Aug 22, 2016
docs Update Sep 13, 2016
gulp fix error in concatjs util script Sep 8, 2016
public docs on routing for single-page apps Sep 8, 2016
scripts fix which branch is rebuilt in docs site Aug 27, 2016
src middleware initialization methods now take App as first parameter Sep 12, 2016
test middleware initialization methods now take App as first parameter Sep 12, 2016
.jshintrc Update documentation. Enforce use strict pragma. Apr 18, 2014
.npmignore update npmignore May 15, 2016
.travis.yml fix deploy line Aug 31, 2016 fixed routeUrl template var Aug 24, 2016 updated readme, contributing guide, gulp script Aug 16, 2016 Renamed 'view formats' to 'output formats' since view formats mean ja… Feb 20, 2014 update discord badge text Sep 10, 2016 Update docs/best_practices/ Aug 7, 2016
book.json Create book.json Jun 10, 2016 remove console log Dec 27, 2016
package.json middleware initialization methods now take App as first parameter Sep 12, 2016
start-app.js exit app if bootstrap fails May 1, 2016


Build Status NPM module Waigo channel on discord Follow on Twitter

[ Getting startedGuide ]

Waigo is a Node.js ES6 framework for building web apps and API back-ends which are easy to maintain and improve, and easy to scale.

Quick overview:

  • Built on koa, uses Promises and Generators, no callbacks.
  • Uses RethinkDB for end-to-end reactive data pipeline.
  • Build APIs and output both HTML and JSON for every route.
  • Flexible routing with per-route and per-HTTP-method middleware customisation.
  • Customizabe logging framework.
  • Form validation and sanitization CSRF protection.
  • User accounts, roles and access control lists. OAuth supported.
  • Emailing system with email templating support.
  • Slack notifications, fully configurable.
  • Command-line client for quick and easy setup
  • Pluggable admin interface (see waigo-plugin-admin).
  • Cron jobs.
  • Node.js clustering (multi-process) scaling support.
  • Extend or override any part of the core framework.
  • Bundle up functionality and customizations into re-usable plugins (NPM modules).
  • And much, much more...


Full documentation can be found in the /docs/ folder. The same docs can also be read online at

Note: Waigo v2 (current major version) was only recently completed, and as such docs are still a work in progress. The old v1 docs can be found at


Note: This section tells you to build Waigo itsef. For building apps with Waigo please read the docs instead.


  • Node.js 4.4.5+
  • RethinkDB 2.2+

First install the dependencies:

$ npm install

Now you can run the development server using:

$ npm run dev

This will watch assets and source code for changes and rebuild and reload the browser page when necessary.

If you install gulp globally then you can also run it directly:

$ npm install -g gulp
$ gulp dev

Running it directly lets you pass in additional options. For example, by default assets are not minified. To enable minification use the --debug flag:

$ gulp dev --minified


$ gulp test

This will run all the tests. To limit testing to one more test files use the --only-test option:

$ gulp test --only-test test/unit/src/support/*.test.js

Waigo v1

Version 1 is the old version of Waigo and uses Mongo instead of RethinkDB. This version is no longer being maintained but feel free to fork it from the v1 branch in the repo. Docs can be found


Suggestions, bug reports and pull requests are welcome. Please see for guidelines.

If you have any questions, come and chat with us on Discord.


MIT - see