Designing State Shape sits at the heart of state structure in Redux. This guide walks through the concept step by step, with examples, a cheatsheet, and common mistakes to avoid.
Designing State Shape Overview
Designing State Shape is something you will reach for often in Redux. It keeps your workflow predictable and makes your intent obvious to reviewers and teammates.
When you learn designing state shape properly, you avoid the guesswork that leads to mistakes and rework. The example below shows the shape you will use in most real Redux projects.
import { configureStore } from '@reduxjs/toolkit';
import { Provider } from 'react-redux';
const store = configureStore({ reducer: rootReducer });
function App() {
return (
<Provider store={store}>
<Root />
</Provider>
);
}
A Provider makes the single Redux store available to every component in the tree.
Start from a minimal Designing State Shape example and grow it only as needed.
Keep things explicit so Designing State Shape behaves the same for everyone on the team.
Name things clearly so teammates understand your Designing State Shape at a glance.
Verify Designing State Shape works as expected before relying on it in important work.
Redux Cheatsheet
Quick Redux Toolkit reference related to designing state shape.
Concept
Example
Purpose
Store
configureStore({ reducer })
Hold app state
Slice
createSlice({ name, reducers })
State + actions together
Read state
useSelector((s) => s.x)
Get data in components
Dispatch
useDispatch()
Send actions
Async
createAsyncThunk(...)
Handle side effects
Data fetching
createApi(...)
RTK Query endpoints
Derived data
createSelector(...)
Memoized computations
How Designing State Shape Works in Redux
Designing State Shape follows Redux's predictable data flow: components dispatch actions, reducers compute the next state from the previous state and the action, and subscribed components re-render.
A Provider makes the single Redux store available to every component in the tree.
State lives in a single, read-only store.
Actions are the only way to describe a change.
Reducers are pure functions that return the next state.
Redux Toolkit removes most boilerplate with slices and thunks.
Practical Guidance for Designing State Shape
In modern apps, designing state shape should use Redux Toolkit rather than hand-written Redux. Keep state minimal, colocate logic in slices, and use RTK Query for server data.
Concern
Recommendation
Boilerplate
Use Redux Toolkit (createSlice)
Server data
Prefer RTK Query over manual thunks
Performance
Memoize selectors with createSelector
Types
Use typed useAppSelector/useAppDispatch hooks
Common Mistakes
Skipping edge cases and error handling when using designing state shape.
Not verifying the result of designing state shape before moving on.
Over-complicating designing state shape before you actually need the extra flexibility.
Ignoring documentation, which makes designing state shape hard for the next person to follow.
Key Takeaways
Designing State Shape is a core part of working effectively with Redux.
Start small and keep designing state shape focused on a single goal.
Apply consistent patterns so designing state shape scales across your project.
Practise and document designing state shape to keep your workflow maintainable.
Pro Tip
Practise designing state shape on a throwaway project first. It is far cheaper to learn Redux mistakes there than on important work.
You now understand designing state shape in Redux and how to apply it in real projects. Next, continue with Avoid Duplicate State to keep building your skills.