Exciting release!Introducing "safe npm". Learn more
Socket
Log inDemoInstall

next-redux-store

Package Overview
Dependencies
0
Maintainers
1
Versions
26
Issues
File Explorer

Advanced tools

next-redux-store

Next integration with Redux

    0.3.6latest
    GitHub

Version published
Maintainers
1
Weekly downloads
810
increased by2214.29%

Weekly downloads

Readme

Source

next-redux-store

npm

Next integration with Redux.

Features:

  • state can be passed to the client once on the first render
  • it's also possible to load page-level state between page transitions
  • uses HYDRATE action only for pages that contain state in their props
  • SSG and SSR work great

Installation

npm i next-redux-store

Demo

Demo with RTK Query / Source

Usage

  1. Configure your custom App to use Redux store
import { AppProps } from 'next/app'; import { StoreProvider } from 'next-redux-store'; import { makeStore } from 'modules/makeStore'; export default function _App(appProps: AppProps<any>) { const { Component, pageProps } = appProps; return ( <StoreProvider makeStore={makeStore} appProps={appProps}> <Component {...pageProps} /> </StoreProvider> ); }

NOTE: makeStore must accept preloadedState as an argument. See example.

  1. Configure your custom Document to provide initial state for the App
import { createGetInitialProps } from 'next-redux-store/server'; import { makeStore } from 'modules/makeStore'; const getInitialState = async (ctx, appProps) => { const store = makeStore(); // Fill the store considering the App props and Document context // See example (https://github.com/fakundo/next-redux-store/blob/master/packages/docs/pages/_document.tsx#L14) return store.getState(); } export default class _Document extends Document { static getInitialProps = createGetInitialProps(getInitialState); render() { ... } }
  1. Optional if you also would like to load state data for some pages within their props (just like next-redux-wrapper works), you can return that state inside getStaticPaths / getServerSideProps functions. That state will be populated to the store with HYDRATE action. So do not forget to configure reducers to handle it. See example.
import { serverSideState } from 'next-redux-store/server'; export const getStaticProps = async () => { const store = makeStore(); // Fill the store const initialState = store.getState(); return { props: { ...serverSideState(initialState), }, }; }

API

import { StoreProvider } from 'next-redux-store'

import { ProviderProps } from 'react-redux'; interface StoreProviderProps extends Omit<ProviderProps, 'store'> { appProps: AppProps<any>; makeStore: (preloadedState: any | undefined) => any; } declare class StoreProvider extends Component<StoreProviderProps> {}

import { createGetInitialProps } from 'next-redux-store/server';

Function createGetInitialProps creates a function that returns initial props for the Document, providing initial state of the store for the App.

type CreateInitialState = (ctx: DocumentContext, appProps: AppProps<any> | undefined) => any; const createGetInitialProps: (createInitialState: CreateInitialState) => (ctx: DocumentContext) => DocumentInitialProps;

Function createInitialState accepts Document context and App props as parameters and returns initial state of the store.

import { serverSideState } from 'next-redux-store/server';

Function serverSideState accepts state of the store and returns page props.

import { HYDRATE } from 'next-redux-store';

HYDRATE returns name of the hydration action.

License

MIT

Keywords

FAQs

Last updated on 19 Oct 2022

Did you know?

Socket installs a Github app to automatically flag issues on every pull request and report the health of your dependencies. Find out what is inside your node modules and prevent malicious activity before you update the dependencies.

Install Socket
Socket
support@socket.devSocket SOC 2 Logo

Product

  • Package Issues
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc