Skip to content

Slices and SliceGroups that scale. Reduce boilerplate. Split code.

License

Notifications You must be signed in to change notification settings

vmware/slices-for-redux

Repository files navigation

Slices for Redux

build status Contributor Covenant

Slices and SliceGroups that scale. Reduce boilerplate. Split code.

Install

npm install --save @vmw/slices-for-redux

Purpose

The Slices for Redux package intent is to make it easy to write predictable Redux code that scales. It was created to:

  • Reduce code wiring boilerplate
  • Promote better code splitting
  • Promote a predictable folder / files structure
  • Promote reusable encapsulated Redux modules
  • Reduce code merge conflicts

Slices for Redux leverages concepts and tools from the Redux Toolkit and adds some new concepts and tools of its own.

What's Included

Slices for Redux includes:

  • rootSliceGroup: Object that holds a mutable "root-reducer" allowing slice reducers to be added as their code is imported, removes code boilerplate and promotes code splitting.
  • createSlice(): Function that creates a Slice with basic selectors and a mutable "case-reducer" to promote writing sets of case reducers in separate files.
  • createSliceGroup(): Function that creates a SliceGroup to organize and ease the navigation of a large Redux State object.

Documentation

The Slices for Redux docs are available at https://vmware.github.io/slices-for-redux.

Contributing

The slices-for-redux project team welcomes contributions from the community. Before you start working with slices-for-redux, please read our Developer Certificate of Origin. All contributions to this repository must be signed as described on that page. Your signature certifies that you wrote the patch or have the right to pass it on as an open-source patch. For more detailed information, refer to CONTRIBUTING.md.

License

Open source licensed as MIT.