makingsense / react-redux-starter-app

React+Redux starter app with essential development tools

React+Redux starter app

Starter application/kit containing the minimum set of frameworks/libraries/technologies to start working with React and Redux.

Motivation

Sometimes we've found ourselves doing the simplest setup for a particular framework/language, specially in the JavaScript world where these days you have tons of good libraries to help you out.

What do we usually look for? If we are talking about JavaScript then a testing framework, a linting tool and a packaging/building well-known stablished process.

Setting up all these things might take some time so it makes sense to prepare something solid and reuse it. There are a lot of awesome boilerplate/templates out there. Unfortunately most of them contains a fair amount of stuff that I don't use or need.

The idea behind this starter app/kit is that you only have the minimum to start developing an application with React and Redux, testing, linting, packaging/building included. There is not a backend dependency. There is not a database to set up. And there is not a single CSS framework applied. You're completely free.

Included tech/framework/library

Tech	Insights
React	The core JavaScript UI library.
Redux	Manage the state of the application.
Babel	Safely use the next generation JavaScript.
webpack	Bundle all the assets.
Jest	Testing framework.
Enzyme	Testing utilities.
ESLint	Linting utility.
EditorConfig	Define file formats and coding styles for all Editors/IDEs.

Installation

npm install

Run

For development you can simple type:

npm start

Build

For production deployments:

npm run build

Validate

Whether you run start or build scripts both will execute first a validation script which is in charge of running the linting and testing validations.

npm run validate

You can run them in isolation too:

npm run lint

npm test

Alternatives

There is a big chance this project does not fulfill your needs. We recommend these fantastic alternatives:

1. Create React App
2. react slingshot

Both of them have been here for some time and have very nice communities and support. Please, chech those out!

react-redux-starter-app's Issues

Evaluate code splitting strategies

Add React Hot Loader

See https://github.com/gaearon/react-hot-loader.

Evaluate Redux-Saga

Is it worth it? https://redux-saga.js.org

If the answer is positive, then attempt to use it.

Evaluate Migrate to yarn

Evaluate and update Webpack to v4

Evaluate and update if appropriate. See https://medium.com/webpack/webpack-4-released-today-6cdb994702d4.

Update to React 16.3 or latest

See more details: https://reactjs.org/blog/2018/03/29/react-v-16-3.html

Implement Redux-Saga

This is a placeholder in order to review the addition of redux sagas based on our extended version of this seed with Sagas

Add e2e testing

Research and evaluate the different alternatives and implement the most standard between the community but also the less invasive.

Include validation in login form

Without including any component, plugin or library.

Add production build

Evaluate deployment to GH pages

It would be nice to have the starter app running using GH pages.

Ensure linting and tests are executed on watch mode

I think I saw this not working as expected. Linting and tests were executed only on the first run. We should validate the code for each change when watching for changes.