redux-persist

<p align="center">
  <img src="https://raw.githubusercontent.com/endograph/redux-persist/master/favicon.svg" alt="redux-persist" width="120" />
</p>

<p align="center">
  <a href="#quickstart">Quickstart</a> ·
  <a href="docs/api.md">API</a> ·
  <a href="docs/storage-engines.md">Storage engines</a> ·
  <a href="https://www.npmjs.com/package/redux-persist">npm</a>
</p>

# redux-persist

[![CI](https://img.shields.io/github/actions/workflow/status/endograph/redux-persist/ci.yml?branch=master)](https://github.com/endograph/redux-persist/actions/workflows/ci.yml)
[![npm](https://img.shields.io/npm/v/redux-persist)](https://www.npmjs.com/package/redux-persist)
[![npm next](https://img.shields.io/npm/v/redux-persist/next?label=next)](https://www.npmjs.com/package/redux-persist?activeTab=versions)
[![downloads](https://img.shields.io/npm/dm/redux-persist)](https://www.npmjs.com/package/redux-persist)
[![license](https://img.shields.io/npm/l/redux-persist)](LICENSE)

Persist and rehydrate a redux store. Your state is saved to storage as it
changes and restored into the store when your app starts.

> Hey all! redux-persist is maintained again, and **v7 is in beta**
> (`npm install redux-persist@next`): Redux Toolkit 2 support with no extra
> setup, a fix for stored data getting wiped
> ([#809](https://github.com/endograph/redux-persist/issues/809)), and lots
> more. Please try it and tell us how it goes in
> [the v7 beta discussion](https://github.com/endograph/redux-persist/discussions/1527).
>
> These docs are for v7, which needs Redux 5 or Redux Toolkit 2. Upgrading
> from 6? Read the [migration guide](docs/MigrationGuide-v7.md); your stored
> data carries over as is. For 6.x, see the
> [v6 docs](https://github.com/endograph/redux-persist/tree/v6#readme).

- **Drop-in.** Wrap your root reducer with `persistReducer` and call
  `persistStore`. Nothing else in your app changes, and Redux Toolkit needs no
  extra setup.
- **Any storage.** localStorage and sessionStorage ship in the box;
  AsyncStorage, IndexedDB, the filesystem and more plug in —
  [storage engines](docs/storage-engines.md).
- **You choose what's saved.** Allow or block keys, nest persisted reducers
  for finer control, and transform state on the way in and out.
- **Versioned.** Migrations upgrade stored state when its shape changes —
  [how migrations work](docs/migrations.md).

## Quickstart

```sh
npm install redux-persist
```

Wrap your root reducer and create a persistor alongside the store:

```ts
// app/store.ts
import { configureStore, combineReducers } from '@reduxjs/toolkit'
import { persistStore, persistReducer } from 'redux-persist'
import storage from 'redux-persist/storage' // localStorage on the web
import userReducer from './features/user/userSlice'
import configReducer from './features/config/configSlice'

const rootReducer = combineReducers({
  user: userReducer,
  config: configReducer
})

const persistConfig = {
  key: 'root',
  version: 1,
  storage,
}

const persisted