(Mostly) Presentational React components for Rize


Keywords
rize, rize-blocks, react, storybook, styled-components, storybooks
License
MIT
Install
npm install @rize/blocks@2.0.8

Documentation

Rize Blocks

npm version styled with prettier

React component library for the Rize Savings Web App. Interactive storybook at Rize Blocks.

Overview

At Rize, UI components are developed in this library and then imported into our main application where they are wired up to their container components[0]. By separating the presentational components into their own library, we are able to enforce a strict separation of concerns and deeply enforce a single responsibility rule of how components that render UI should only be concerned with their appearance and interactivity (and not be concerned with application/implementation details).

How We Use This

This library is symlinked locally with the main application. Rize Blocks builds to ES6 modules, so the bundling process is taken care of in a downstream build process. The ES6 module build also permits tree-shaking in the cases that there are unused (experimental/deprecated) components.

Seems like overkill? This workflow works well for us for a two major reasons:

  1. Designing presentational components and their props happens in isolation, therefore props and components design tends to be less coupled to our app's state
  2. These components are developed entirely in storybooks, which provides an incredible developer's experience and imparts very high cohesion (the component visually align) and loose coupling (the components can exist independently to the largest extent possible)

Developing Presentational Components

Simplest

Components are developed in individual stories.

Salt and Pepper

In cases where components have contextual dependencies on other presentational components, they can be developed in a story that has a combination of several components (e.g. seeing how a <Button /> component integrates with the bottom of a <Panel /> component in a <Modal />).

Fully Loaded

The only intances with considerable cohesion between the blocks and the main application is with forms. The link is in ./.storybook/config.js, where redux-form is configured. This permits us to develop controlled components in stories.