Marvin ★★

React and Redux, Webpack 2 boilerplate.

Marvin is internal project by Work & Co. We love React and use it a lot. So Marvin is meant to be a starting point for our React projects. But as we love open source too, it is publicly available for anyone interested in using it.

Name comes from a fictional character Marvin, android from the The Hitchhiker's Guide to the Galaxy book as a homage to it's author Douglas Adams.

Table of contents

• What is this?
• Features
• Setup
• npm tasks
• Running in dev mode
• Running it with webpack dashboard
• Build client (production)
• Running client in preview production mode
• Universal dev mode
• Universal build (production)
• Removing server rendering related stuff
• Linting
• Git hooks
• Misc
• Changelog

What is this?

Boilerplate for kicking off React/Redux applications.

It includes complete, minimal react app. By complete we mean it has examples for:

• components (both container/views and regular ones)
• routes
• reducers (redux)
• actions (both sync and async),
• SASS (with autoprefixer)¹
• dummy API
• using assets (in CSS and components)
• imports relative to the app root

¹ Using source maps breaks urls in the CSS loader - webpack-contrib/css-loader#232. Try this to fix it (but it breaks testing from local network).

Features

• React
• React router
• Redux
• Redux Thunk
• Redux DevTools (you need to have browser extension installed)
• Universal rendering
• Webpack 3 (development and production config)
• Hot Module Replacement
• Immutable reducer data
• Babel - static props, decorators
• SASS with autoprefixing
• Webpack dashboard
• Linting
• Included es6-promise and isomorphic-fetch
• Preview production build
• File imports relative to the app root
• Git hooks - lint before push
• Tree shaking build
• Import SVGs as React components

TODO

• Switch to redux-saga
• Server async data
• Internationalization

Setup

Tested with node 7.x and 8.x

$ npm install

npm tasks

• start - starts client app only in development mode, using webpack dev server
• client:dev - same as start plus fancy webpack dashboard
• client:watch - not to be used on it's own, starts webpack with client config in watch mode
• client:build - builds client application
• client:preview - runs client application in production mode, using webpack dev server (use for local testing of the client production build)
• server:watch - not to be used on it's own, starts webpack with server config in watch mode
• server:restart - not to be used on it's own, server build run using nodemon
• server:build - not to be used on it's own, builds server application
• server:dev - starts server app only in development mode (use for testing server responses)
• universal:dev - runs both server and client in watch mode, automatically restarts server on changes
• universal:build - builds both server and client

Running in dev mode

$ npm start

Visit http://localhost:3000/ from your browser of choice. Server is visible from the local network as well.

Running it with webpack dashboard

$ npm run client:dev

Note for Windows users: webpack dashboard still have issues with Windows, so use npm start until those are resolved.

OS X Terminal.app users: Make sure that View → Allow Mouse Reporting is enabled, otherwise scrolling through logs and modules won't work. If your version of Terminal.app doesn't have this feature, you may want to check out an alternative such as iTerm2.

Build client (production)

Build will be placed in the build folder.

$ npm run client:build

If your app is not running on the server root you should change publicPath at two places.

In webpack.config.js (ATM line 147):

output: {
  path: buildPath,
  publicPath: '/your-app/',
  filename: 'app-[hash].js',
},

and in source/js/routes (ATM line 9):

const publicPath = '/your-app/';

Don't forget the trailing slash (/). In development visit http://localhost:3000/your-app/.

Running client in preview production mode

This command will start webpack dev server, but with NODE_ENV set to production. Everything will be minified and served. Hot reload will not work, so you need to refresh the page manually after changing the code.

npm run client:preview

Universal dev mode

npm run universal:dev

Visit http://localhost:8080/ from your browser of choice. Server is visible from the local network as well.

Universal build (production)

npm run universal:build

copy package.json and build folder to your production server

install only production dependencies and run server

npm install --production

node ./build/server.js

Removing server rendering related stuff

If you are not using server rendering remove following packages from package.json

• express
• transit-immutable-js
• transit-js
• nodemon
• concurrently

Also open source/js/config/store.js and remove lines marked with the following comment

// Remove if you are not using server rendering

Client app is going to work without this but, it will include few unused packages. Therefore it is better to remove them.

Linting

For linting I'm using eslint-config-airbnb, but some options are overridden to my personal preferences.

$ npm run lint

Git hooks

Linting pre-push hook is not enabled by default. It will prevent the push if lint task fails, but you need to add it manually by running:

npm run hook-add

To remove it, run this task:

npm run hook-remove

Misc

Importing images in SCSS

Please note that paths to images in SCSS files are relative to source/scss/base/main.scss as it imports all of the other .scss files.

.BackgroundImgExample {
  background-image: url(../assets/img/book1.jpg);
}

Check the example in source/scss/base/_app.scss

Importing SVGs as components

Just import your .svg files from the source/assets/svg/ folder, and you are good to go.

import CircleSvg from '../../../assets/svg/circle.svg';

// then in your render

<CircleSvg />

Check the example in source/js/views/Dashboard/index.jsx

---

Changelog

0.2.0

• Webpack updated to v3 and rewritten webpack config
• Optional universal rendering
• A lot of code changes

0.1.7

• Migrated to React Router 4.x (thanks @shams-ali)
• Added .editorconfig file
• Fixed couple of typos

0.1.6

• Added SVG icon loader (SVG sprite) #18

0.1.5

• npm start is not using webpack-dashboard by default cause it still has issues with Windows
• Moved prop-types from devDependencies to dependencies

0.1.4

• Resolved React 15.5 deprecation warnings

0.1.3

• Made sure tree shaking is working
• Removed DevTools from the code, but it still works if you have browser extension

0.1.2

• Fixed duplicating vendor bundle code
• Reduced overall bundle size by disabling devtool in production

0.1.1

• Fixed running it on Windows machines

0.1.0

• Updated webpack to a stable version

0.0.3

• Added pre-push git hook
• Added preview task

0.0.2

• Added Redux Dev Tools.
• Renamed client to source
• Made sure logger and DevTools are loaded only in development

0.0.1

Initial release