next-redux-store

next-redux-store

Next integration with Redux.

Features:

• state can be passed to the client once on the first render
• does not require to load 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 { makeStore, Provider } from 'modules/redux';
import { createUseStore } from 'next-redux-store';
import { AppProps } from 'next/app';

// Note that makeStore must accept preloadedState as an argument
const useStore = createUseStore(makeStore);

export default function _App(appProps: AppProps<any>) {
  const { Component, pageProps } = appProps;
  const store = useStore(appProps);
  return (
    <Provider store={store}>
      <Component {...pageProps} />
    </Provider>
  );
}

1. Configure your custom Document to provide initial state for the App

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

const getInitialState = async (appProps, ctx) => {
  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 with 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.

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

- createUseStore

createUseStore creates a React hook that returns a Redux store. It accepts a store creation function with a preloadedState as parameter. The hook accepts App props.

type MakeStore = (preloadedState: any | undefined) => Store;
const createUseStore: (makeStore: MakeStore) => (appProps: AppProps<any>) => Store;

- createGetInitialProps

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

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

createInitialState can accept two parameters: App props and Document context.

- serverSideState

serverSideState accepts state of the store and returns page props.

- HYDRATE

HYDRATE returns hydration action name.

License

MIT