redux-replicate-localforage

Replicator for redux-replicate designed to locally persist the state of redux stores using localforage.

Table of contents

1. Installation
2. Usage
3. Example using react-redux-provide
4. Example using compose
5. Debouncing

Installation

npm install redux-replicate-localforage --save

Usage

Use with redux-replicate.

Example using react-redux-provide

1// src/replication.js
2
3import localforage from 'redux-replicate-localforage';
4import { theme } from './providers/index';
5
6theme.replication = {
7  reducerKeys: ['themeName'],
8  replicator: localforage
9};

Example using compose

1import { createStore, combineReducers, compose } from 'redux';
2import replicate from 'redux-replicate';
3import localforage from 'redux-replicate-localforage';
4import reducers from './reducers';
5
6const initialState = {
7  wow: 'such storage',
8  very: 'cool'
9};
10
11const key = 'superCoolStorageUnit';
12const reducerKeys = true;
13const replicator = localforage;
14const replication = replicate({ key, reducerKeys, replicator });
15const create = compose(replication)(createStore);
16const store = create(combineReducers(reducers), initialState);

Debouncing

By default, a debounce occurs when writing the next state to localforage (during onStateChange). The default timeout is 10 milliseconds. You can change it by doing this:

1import localforage from 'redux-replicate-localforage';
2
3localforage.debounce = 20;