Setting up your Redux Store
If you read the articles I publish weekly you know that I’m a fan of React Native and Meteor. I use them everyday and I spend time teaching how to use them every night.
When you’re building a React or React Native app you’re likely going to end up using some flavor of Flux. I personally use Redux.
I’ll be doing a full in-depth overview of how to use Redux in a React Native app in my upcoming course (sign up for my email list for details!) but today I want to talk through setting up the store for your Redux implementation. It’s something that you’re rarely going to touch once it’s set up, can be confusing when you start a new project, and is pretty important.
So today I want to talk you through how I configure a store for Redux — purely opinion but it works for me :)
I don’t want to overwhelm you but I do want to give you a sense of what we’re using and why we’re going to use it. There are definitely other options but this is what I’ve been using in my day job.
redux: You’re probably familiar with this one! We’re going to use createStore and applyMiddleware. createStore is pretty straightforward and applyMiddleware is there to tack on the middleware we’ll be using, covered below.
redux-immutable-state-invariant: Rather than using something like immutable.js to ensure immutability We’ll just be using this package to ensure we don’t accidentally mutate state. Immutable.js has a lot of benefits but it’s also got a learning curve — it’s up to you to make the decision.
redux-logger: Logs our previous state, the action that is dispatched, and the resulting state. It’s awesome to be able to track down what’s happening, when it’s happening, and the result of what happened.
redux-storage: Stores our state on the client so that some/all of it is available as soon as the client loads our app up the next time they visit us. This works for both React (via localStorage) and React Native (via AsyncStorage). We’re also going to touch on some of the extensions you can use.
First thing we want to do is just get a basic store set up. We’re going to do a little extra here so we can integrate the other pieces easier. To the code!
Logging will be really easy to set up. Two things to note about this:
- The logger always has to be the last middleware added to the stack to function properly
- We’re passing the predicate in because we don’t want this middleware to run in the production environment. It’s purely a debugging tool.
Here’s the updated store file
Adding Immutability Check
This is another really simple one to set up. We just need to require it and push it to the middleware stack. Again this is purely for debugging so we don’t want to include it in the production release.
Persist Redux Store
This will be our most complex middleware setup. First we’ll set it up in the most basic way — store after every action. I’m using the react native storage engine here because it means I can copy & past code from other projects. The same should apply for the web. I wrapped the new code in comment blocks so it’s easier to find.
Beyond the new pieces of code you can see that we modified the makeStore function to load the old store data. We also add a callback argument to the function so that you can do something once the old store has loaded. It follows the error, result pattern.
Improving Redux Storage — Adding Debounce and Filter
Right now the store that is persisted will be updated after every action is dispatched and the entire state tree will be copied. This can be inefficient if you’re dispatching a lot of actions in a small amount of time (like making multiple requests on app load). Fortunately we can extend redux-storage to account for that.
What we’re going to do is only persist the store once per second. This will help with the possibility of a lot of actions being dispatched in rapid succession.
Then we’re only going to store the auth key of store. You might want to use this if the data may be out of date quickly but you expect that a user session is going to succeed the next time they open the app.
Here’s the code
That’s a pretty easy to set up store that will carry you a long way. There’s more you can do if you want but I haven’t ventured beyond that.
If you found this helpful consider signing up for my email list! I write a new post nearly every week and am currently putting together a course on building an app with React Native and Redux.