node package manager

zeroconf-redux

zeroconf-redux

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

Installation | Usage | License

NPM version Dependency Status

NPM downloads

This is an empty package, there is almost no code implemented, only a set of dependencies:

I am using greenkeeper.io to keep dependencies up to date, then publish them as patch versions.

Installation

With npm v3 do

npm install zeroconf-redux --save-dev

Usage

Quick start

Assumption: your project folder contains an index.js with a console.log('Hello World').

Just install

npm i zeroconf-redux

and launch the dev server with

node_modules/.bin/budo index.js --live --open -- -t babelify

Your browser will open and you can start coding now!

Read below for more details and instructions to improve this quick process and launch your dev server with a simple npm start.

Use a package.json

If you have no package.json yet, I highly recommend to create one, for instance with

npm init

or even (for the lazy ones like me :^) npm init -y.

Install and save it as a development dependency.

npm install zeroconf-redux --save-dev

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>
<html>
  <body>
    <div id="root"></div>
    <script src="bundle.js"></script> 
  </body>
</html>

... 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

Customization

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.

LiveReactload

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')
 
render(
  <AppContainer>
    <Component />
  </AppContainer>,
  root
)

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.

License

MIT

OS icons provided by icons8.