sagamatron

SAGAMATRON

Take the boilerplate out of your React/Redux/Saga stack using the magic of TypeScript! 🧙

Summary

A project to reduce the amount of boilerplate that needs to be written for redux/redux-saga based applications.

Developed for an Agile Digital "Fedex Day".

Motivation

Here at Agile Digital we are big on using Redux and Sagas to manage state and side effects.

However, the benefits of redux-saga come with a downside. There is a lot of boilerplate code that needs to be written to support the patterns enforced by redux and redux-saga.

This can discourage developers from using these patterns, and can sometimes make simple features to take extra time to implement.

In newer versions of React, new forms of state management have been introduced in the form of hooks. While they have their rightful place in a React application, for example when managing temporary UI state, their simplicity can tempt developers to manage more and more of the application's state using them. Initially this trade off might seem successful due to faster cycle times and a perceived reduction in complexity but their are hidden costs that will appear later in the lifecycle of a project.

To try and avoid this trend, we decided to use the power of TypeScript to reduce the boilerplate of redux and redux-saga.

Example

The unit tests are a good example of how it all works:

• https://github.com/agiledigital/sagamatron/blob/master/src/concoctBoilerplate.test.ts
• https://github.com/agiledigital/sagamatron/blob/master/src/concoctCrud.test.ts

We also have a basic project that demonstrates how sagamatron integrates with everything: https://github.com/agiledigital/react-redux-saga-sagamatron