redux-examples

The purpose of this application is to document what the basic building blocks to connect Redux to a React.Js application. Most examples online use that silly ToDo app and it goes over my head all the time.

Install

npm install && npm start

Usage

The details on each topic will be in the /docs directory. The source code is functional once you run the app, but it's mainly for reference.

Basic structure

+-- dist
|   +-- index.html
+-- src
|   +-- reducers
|       +-- index.js
|   +-- app.js
+-- index.js

index.js

The main purpose of this file is to be the root of the application. Node is configured to look for this file as the starting point (you can change it when applicable). As it relates to React there are various key imports happening here:

react - the core React.Js library
react-dom - used to render the application to the div#app element in ./dist/index.html.
createStore (redux) - used to create a store and use an initial state of the application from the reducer.
applyMiddleware (redux; optional) - used to add additional tools (ie: redux-logger)
Provider (react-redux) - acts as the bridge between the Redux store and the application. All it does is provides access to the store, it doesn't interact with action creators or reducers directly.

src/app.js

The purpose of this file (in the context of this app) is to act as a Home Page for the user. No connection is made to Redux.

src/pages/functional-component.js

The purpose of this file is to demonstrate a functional React component connecting to the store.

connect (react-redux) - used as a way for this component to interact with the store, reducers, and action creators.

src/reducers/index.js

The purpose of this file is to update the store with a new application state. In the root file index.js the expected input for createStore() is a function that returns the state.

fergatron / redux-examples