node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org ¬Ľ



is a minimal React/Redux dev stack, on top of browserify + budo

UPDATE ūüéČ: v2 contains brand new React v16 ūüėé

Quick start | Usage | Customization | License

Whatchers Stargazers Forks

NPM version Dependency Status

Quick start

Just run

npm install zeroconf-redux
npx zeroconf-redux
# Yay! 

Your browser will open and you can start coding your awesome React/Redux web app now!

If it does not exists, a basic index.js file will be created to be used as the entry for your budo dev server.

Read below for more details and instructions about how to create a package and launch your dev server with an npm start.


If you have no package.json yet, create one now! For instance with npm init or even (for the lazy ones like me :^)

npm init -y

Tip: if it is not a package you want to add on the npm registry, consider adding a

  "private": true,

attribute to your package.json file.

Then with npm do

npm install zeroconf-redux --save-dev

The following dependencies will be installed:

On postinstall a .babelrc is created, if it does not exists. It has the following content

{ "presets": [ "es2015", "react" ] }

If you want to trigger it manually, you can run

npm explore zeroconf-redux npm run copy_babelrc

Assuming there is an index.html in the same folder as the package.json with a content like the following...

<!DOCTYPE html>
    <div id="root"></div>
    <script src="bundle.js"></script> 

... add an npm script to your package.json, to run budo dev server, something like

    "start": "budo index.js --dir . --serve bundle.js --live --open -- -t babelify",

Now, running npm start it will

  1. Build your code using index.js as entry.
  2. Open your index.html in your browser.
  3. Start watching HTML, JS and CSS files, with livereload on changes.

In the examples/counter folder there is a copy of the classic Redux counter example. You can run it with this command

npm explore zeroconf-redux npm run example_counter


Babel presets

If you need more babel presets or plugins, other than babel-preset-es2015 and babel-preset-react, just install and add them to your .babelrc.

Async Redux

Probably you need to call an asynchronous API: the standard way is to use the Redux Thunk middleware, so you need to install

npm install redux-thunk --save

But this choice is up to you, since there are few alternatives this package does not include a middleware to dispatch async actions. See Async Actions chapter on official Redux documentation for details.


You can benefit from awesome hot reloading feature using livereactload.

Install dependencies

npm install livereactload@next react-hot-loader@next

Use a .babelrc like the following

  "presets": ["es2015", "react"],
  "plugins": ["react-hot-loader/babel"]

You can create it if you launch

rm .babelrc
npm explore zeroconf-redux npm run copy_babelrc_livereactload

I assume you have an index.html, with a div having an app id. Note that your code must be idempotent in order to let livereactload do its magic, see more details here.

When you create your application you need something like

import React from 'react'
import { render } from 'react-dom'
import { AppContainer } from 'react-hot-loader'
import Component from './components/Component'
const root = document.getElementById('app')
    <Component />

Then add the following npm script to your package.json

"start": "NODE_PATH=. budo -d . -s bundle.js -o index.js -- -t babelify -p livereactload",

Now, launching npm start you can edit your code and it will be injected in your page without losing the state.



OS icons provided by icons8.