endograph/redux-persist

O que é?

Recursos principais

• 01Envolve o reducer raiz com persistReducer e cria um persistor com persistStore.
• 02Inclui suporte a localStorage e sessionStorage, com mecanismos de armazenamento configuráveis para outros backends.
• 03Permite escolher as chaves salvas com allowlist e denylist ou com uma função de filtro.
• 04Oferece suporte a persistências aninhadas, transformações de estado e migrações versionadas.
• 05Disponibiliza PersistGate e useRehydrated para que o React aguarde a restauração do estado.

Casos de uso

• Manter preferências do usuário ou estado relacionado ao login entre recarregamentos do navegador em um app React.
• Persistir o estado do Redux em um app React Native com AsyncStorage.
• Salvar o estado do app offline em uma PWA ou app desktop que use IndexedDB ou o sistema de arquivos.
• Atualizar com segurança o estado armazenado quando a estrutura de uma slice do Redux mudar entre versões.

Início rápido

1. 1

   Instale o pacote pelo npm

   npm install redux-persist
2. 2

   No arquivo da sua store, envolva o reducer raiz com persistReducer e crie um persistor com persistStore

3. 3

   Envolva o componente raiz com PersistGate de redux-persist/react (opcional, para React)

Antes de usar

• !A v7 requer Redux Toolkit 2 ou Redux 5.
• !A versão v7 está em beta (instale com a tag next).

Tópicos

Perguntas frequentes

O que é redux-persist?

Uma biblioteca no estilo middleware do Redux que salva o estado da store em um armazenamento e o restaura quando o app é iniciado. redux-persist salva o estado da store do Redux em um armazenamento conforme ele muda e o reidrata na store ao iniciar, para que os usuários mantenham seus dados entre carregamentos de página ou inicializações do app. Você envolve o reducer raiz com persistReducer e cria um persistor com persistStore; o restante do app continua igual, e o Redux Toolkit funciona sem configuração extra.

redux-persist é gratuito? Qual é a licença?

redux-persist é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

redux-persist ainda é mantido?

Manutenção ativa. O último commit de redux-persist foi em 7 de out. de 2026.

Para que posso usar redux-persist?

Manter preferências do usuário ou estado relacionado ao login entre recarregamentos do navegador em um app React. Persistir o estado do Redux em um app React Native com AsyncStorage. Salvar o estado do app offline em uma PWA ou app desktop que use IndexedDB ou o sistema de arquivos. Atualizar com segurança o estado armazenado quando a estrutura de uma slice do Redux mudar entre versões.

Como instalar redux-persist?

Instale o pacote pelo npm: npm install redux-persist No arquivo da sua store, envolva o reducer raiz com persistReducer e crie um persistor com persistStore Envolva o componente raiz com PersistGate de redux-persist/react (opcional, para React)

Onde consigo redux-persist?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/endograph/redux-persist