Redux Preboiled
Pre-cooked Redux helpers, served à la carte.
Redux Preboiled is a collection of general-purpose Redux helper functions. It helps you reduce boilerplate when writing reducers, action creators, and tests.
- Served à la carte. Each of Preboiled's helpers can be used stand-alone. Just pick and use the ones you want and ignore the rest. If your build setup does tree shaking, the unused helpers won't even be added to your application's build output.
- Minimal magic. Preboiled avoids clever "magic" tricks which minimize boilerplate at the expense of understandability. Instead, it favors simple, composable functions with easy-to-understand semantics and implementations.
- TypeScript-friendly. Redux Preboiled is written in TypeScript. Its helpers are designed to be easy to type and amenable to automatic type inference, making it easy to write type-safe Redux code.
The following snippet uses a bunch of Redux Preboiled's helpers to define a simple Redux counter module with support for
increment and multiply actions. It is about half the size of the equivalent vanilla Redux code.import {
chainReducers,
createAction,
onAction,
withInitialState
} from 'redux-preboiled'
const increment = createAction('increment')
const multiply = createAction('multiply').withPayload()
const counterReducer = chainReducers(
withInitialState(0),
onAction(increment, state => state + 1),
onAction(multiply, (state, action) => state * action.payload)
)
// Example usage:
import { createStore } from 'redux'
const store = createStore(counterReducer)
store.dispatch(increment())
store.dispatch(increment())
store.dispatch(multiply(2))
store.getState()
// => 4
createActiongenerates various types of action creator functions with minimal cerenomy. The specified action type value is made available as an action creator property (increment.typeandmutliply.typein this example), making separate action type constants unnecessary. See the Actions guide.- The
onAction,withInitialStateandchainReducershelpers can be combined as a less noisy alternative to the classicswitchreducer pattern. In TypeScript, the type of the sub-reducers'actionparameters are automatically inferred from the action creators passed toonAction, improving type safety and editor auto-completion. See the Reducers guide.
The Getting Started guide shows you how to install and use Redux Preboiled. Follow the links to the other guides for a tour through Redux Preboiled's helpers. You can also look at the repository's examples directory.
Last modified 1yr ago