erikras/ducks-modular-redux — 9.5k★ on GitHub (JavaScript). A proposal for bundling reducers, action types and actions when using Redux
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
I find as I am building my redux app, one piece of functionality at a time, I keep needing to add {actionTypes, actions, reducer} tuples for each use case. I have been keeping these in separate files and even separate folders, however 95% of the time, it's only one reducer/actions pair that ever needs their associated actions.
To me, it makes more sense for these pieces to be bundled together in an isolated module that is self contained, and can even be packaged easily into a library.
MUST have action types in the form npm-module-or-app/reducer/ACTION_TYPE
MAY export its action types as UPPER_SNAKE_CASE, if an external reducer needs to listen for them, or if it is a published reusable library
These same guidelines are recommended for {actionType, action, reducer} bundles that are shared as reusable Redux libraries.
Name
Java has jars and beans. Ruby has gems. I suggest we call these reducer bundles "ducks", as in the last syllable of "redux".
Usage
You can still do:
import { combineReducers } from 'redux';
import * as reducers from './ducks/index';
const rootReducer = combineReducers(reducers);
export default rootReducer;
You can still do:
import * as widgetActions from './ducks/widgets';
...and it will only import the action creators, ready to be passed to bindActionCreators().
Actually, it'll also import default, which will be the reducer function. It'll add an action creator named default that won't work. If that's a problem for you, you should enumerate each action creator when importing.
There will be some times when you want to export something other than an action creator. That's okay, too. The rules don't say that you can onlyexport action creators. When that happens, you'll just have to enumerate the action creators that you want. Not a big deal.
Run cry --help to check more info about the generators available;
Implementation
The migration to this code structure was painless, and I foresee it reducing much future development misery.
Although it's completely feasable to implement it without any extra library, there are some tools that might help you:
extensible-duck - Implementation of the Ducks proposal. With this library you can create reusable and extensible ducks.
saga-duck - Implementation of the Ducks proposal in Typescript with sagas in mind. Results in reusable and extensible ducks.
redux-duck - Helper function to create Redux modules using the ducks-modular-redux proposal
modular-redux-thunk - A ducks-inspired package to help organize actions, reducers, and selectors together - with built-in redux-thunk support for async actions.
molecular-js - Set of utilities to ease the development of modular state management patterns with Redux (also known as ducks).
ducks-reducer - Function to combine ducks object reducers into one reducer (equivalent to combineReducers), and function ducks-middleware to combine ducks object middleware into one single middleware compatible with applyMiddleware.
simple-duck - Class based implementation of modules system, inspired by ducks-modular-redux. All OOP benefits like inheritance and composition. Support combining of duck-module classes and regular reducer functions using combineModules function.
Please submit any feedback via an issue or a tweet to @erikras. It will be much appreciated.
TopGit's last sync did not record any GitHub topics for erikras/ducks-modular-redux. GitHub topics appear in the right sidebar of a repository page; that's the authoritative place to check.
How active is development on erikras/ducks-modular-redux?
The most recent commit recorded on erikras/ducks-modular-redux was 4.8 years ago, based on the GitHub push timestamp. The repository has 336 forks — one of the better signals of community interest.
How many stars does erikras/ducks-modular-redux have?
erikras/ducks-modular-redux has 9.5k GitHub stars — refresh the page for the live number, or check github.com/erikras/ducks-modular-redux. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
What is erikras/ducks-modular-redux?
erikras/ducks-modular-redux (erikras/ducks-modular-redux) is a JavaScript project on GitHub. From the project's own README: A proposal for bundling reducers, action types and actions when using Redux
What language is erikras/ducks-modular-redux written in?
erikras/ducks-modular-redux is written primarily in JavaScript. GitHub's language field is based on the largest share of bytes in the default branch.
Read full README in the tab above.
Still deciding about ducks-modular-redux?
One click hands the question to an AI along with this page — see what it says about ducks-modular-redux.