Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
example Upgrade all deps, remove rwb static Nov 7, 2016
lib Use babel stage 3 Nov 7, 2016
.gitignore react-router 2.0, react-dom Mar 12, 2016 remove static in readme Nov 7, 2016

rwb: the React workbench

rwb has two goals.

  • Reduce "build tool bullshit" to 0
  • Enable sharing of components in npm

Reducing build tool bullshit

  • No codegen: all configs are built inside of rwb. There's a single entry in package.json that tells rwb where your Routes are. When rwb is updated, you'll get the latest webpack config for free.
  • Designed for composable components: there isn't anything specific to single-page-apps in here. Full single-page-apps are just larger components. This can be used for tiny components or huge apps.
  • Best-in-class developer experience: the developer experience is (dare I say) as good as it gets, with source maps, babel and hot reloading working out-of-the-box.

Enable sharing of components in npm

This is a lofty goal.

  • It's hard to share components in npm because there's no standard way to include assets like images, fonts, and CSS.
  • If you build a component with rwb you can assume that loaders are configured for CSS and images.
  • If you want to use a rwb-authored component in your existing app, run rwb validate ./path/to/webpack.config.js to validate that your webpack config has all the loaders that rwb assumes are there.

The great developer experience of rwb is a trojan horse designed to increase adoption of this "standard".

How to develop

npm install -g git+
mkdir myapp
cd myapp
npm init
rwb init
rwb serve

You can change the port by setting the RWB_PORT environment variable: RWB_PORT=3001 rwb serve

Going to production

When you go to production you'll have your own webpack config. rwb validate will ensure that your config will work with components created with rwb.

rwb validate ./path/to/webpack.config.js

Open issues

  • Did we pick the right loaders?
  • Is this going to fragment the npm community? (yes, but that's the price of progress, and we should try to minimize this as much as possible)
  • rwb static should do an opinionated production build.


  • It's not modular and the code sucks. Yep, this was hacked out over the course of a few days on Caltrain, but the design is sane
You can’t perform that action at this time.