j-hannes / realworld-react-redux-modular

React-redux codebase containing real world examples (CRUD, auth, advanced patterns, etc) that adheres to the RealWorld spec and API.

I am aware of the existing React + Redux Real World Example App but for educational purposes, to use a handsome composition of libraries but most importantly to follow a modular architecture with encapsulated modules as described in Jack Hsu's excellent blog post I still want to create this application here myself.

---

Specs: FRONTEND_INSTRUCTIONS

Based on create-react-app (no-escape yet).

It uses the following library stack:

• React
• Redux
• Immutable
• Reselect
• Redux-Saga
• Styled components (not for now, migration too complex)
• Prettier (uses as editor plugin)
• Eslint

The first iteration will be test-free. 😄

In a second iteration I will add:

• Jest unit (and integration?) testing
• Cypress end-to-end testing

In a third iteration I might add

• Flow

I might also experiment in using redux-observable instead of redux-saga.

Later I might also port this application to Elm and/or play with a Haskell backend.

RealWorld

This codebase was created to demonstrate a fully fledged fullstack application built with React-redux including CRUD operations, authentication, routing, pagination, and more.

We've gone to great lengths to adhere to the React-redux community styleguides & best practices.

For more information on how to this works with other frontends/backends, head over to the RealWorld repo.

How it works

This implementation uses a modular segmentation of application logic, so each feature is added as module, containing components, actions, reducers, sagas, selectors etc that concerns around that feature. Each module defines explicitly what is exported, which hides implementation details and gives exposure to what will affect things outside the module on change.

Getting started

❯ npm install
❯ npm start