React Reducer SSR Documentation

React Reducer SSR is a library that serves as an alternative to Redux for managing state in React applications. It leverages built-in React hooks and the context API, offering support for Server-Side Rendering (SSR), selectors, and async actions.

Installation

You can easily install react-reducer-ssr using either Yarn or npm:

# Using Yarn
yarn add react-reducer-ssr

# Using npm
npm install react-reducer-ssr --save

Getting Started

To get started with react-reducer-ssr, you need to import and configure it in your application. Here's a basic setup example:

import React from 'react';
import { ReducerProvider } from 'react-reducer-ssr';
import { reducers } from "./context";

function App() {
  return (
    <ReducerProvider reducer={reducers} initialState={{/* Your initial state */}}>
      {/* Your application components */}
    </ReducerProvider>
  );
}

export default App;

Usage

Creating Reducers

react-reducer-ssr allows you to create reducers to manage your application's state. Here's an example of creating a reducer:

import { TypedUseSelectorHook, useStateSelectorT, combineReducers } from 'react-reducer-ssr'
import { preferencesReducer } from './preferences.reducer'
import { usersReducer } from './users.reducer'

export const reducers = combineReducers({
  preferences: preferencesReducer,
  users: usersReducer
})

export type RootState = ReturnType<typeof reducers>
export const useStateSelector: TypedUseSelectorHook<RootState> = useStateSelectorT

import type { AnyAction } from "react-reducer-ssr";

export interface IUsersState {
  userList?: string[]
}
export function usersReducer(draft: IUsersState, action: AnyAction): IUsersState {
  switch (action.type) {
    case 'GET_ALL_USERS': {
      draft.userList = action.userList;
    } break;
  }
  return draft
}

Immutability

react-reducer-ssr uses 'immer' internally, thus state mutation is allowed. No need to recreate a new object each time state changes.

Using Selectors

Selectors help you access specific parts of your state. Here's how you can use selectors:

import { useStateSelector } from "./context";

const MyComponent = () => {
  const users = useStateSelector(root => root.users);

  return (
    <div>
      {/* Render your selected data */}
    </div>
  );
};

Async Actions

You can perform asynchronous actions with react-reducer-ssr as well. Here's an example:

import { useDispatch } from 'react-reducer-ssr';

const MyComponent = () => {
  const dispatch = useDispatch();

  const fetchData = async () => {
    await dispatch(usersActions.getUsers());
  };

  return (
    <div>
      <button onClick={fetchData}>Fetch Data</button>
    </div>
  );
};

export const usersActions = {
  getUsers
}

async function getUsers(companyCode: string) {
  try {
    const response = await fetch("some_url");
    const userList = await userList.json();
    return { type: 'GET_ALL_USERS', userList }
  }
  catch(err) {
    return { type: 'GET_ALL_USERS_FAILED', err }
  }
}

Server-Side Rendering (SSR) Support

react-reducer-ssr offers support for Server-Side Rendering.

import { reducers } from "./context";
import { createServerStore, DispatchFunction } from 'react-reducer-ssr'

const store = createServerStore(reducers, {/*initial state here*/} as any);

...
await loadData(store.dispatch);
...
async function loadData(dispatch: DispatchFunction, cookies: any) {
  await dispatch(userActions.getUsers());
}

Example

For the complete example see react-ssr-ts-scss-rollup starter template.

Contributing

We welcome contributions from the community! If you'd like to contribute to react-reducer-ssr, please follow our contribution guidelines.

License

This project is licensed under the MIT License. For more information, see the LICENSE file.

Support

For support and bug reports, please open an issue on GitHub.

Feel free to adapt and expand this template as needed to provide comprehensive documentation for your react-reducer-ssr library. Don't forget to create separate documentation files for API reference, FAQs, and contributing guidelines if necessary.