Recoil Flow
Shows a graph of the current recoil state
npm install storybook-addon-recoil-flow
339
Downloads per week

storybook-addon-recoil-flow

Adds a panel to monitor the entire state of recoil for your story.

Recoil Flow Logo

Setup

Method 1: The Recoil Root is provided by another decorator addon

The addon can be installed by just installing via npm / yarn then adding "storybook-addon-recoil-flow" to the addons array in ./storybook/main.js. Ensure that this addon & whichever one is providing the RecoilRoot are in the correct order.

Method 2: The Recoil Root is provided by a decorator within the story

  • Install via npm / yarn
  • Add storybook-addon-recoil-flow/dist/register to the addons array
  • Import withRecoilFlow from storybook-addon-recoil-flow/dist/decorator within your story and put it into the decorators array (in the right order)

Method 3: Just use the RecoilRoot provided by the decorator

  • Install via npm / yarn
  • The decorator provides a RecoilRoot with overrides set to false so the method in 1 will work without another decorator (but you'll not be able to set up a custom initialiser)

Screenshot

Known Issues

  • It's a bit ugly No longer ugly
  • The graph doesn't lay itself out very well Now it does
  • We're not using most of the features of React Flow so we could replace it with something smaller Switched to https://github.com/reaviz/reagraph

Parameters

The recoilFlow parameter has the following optional options:

  recoilFlow: {
    filter: {
      keys: ["AtomOne"],
      showConnected: true,
    },
  },

The keys array gets used in a .startsWith to filter out nodes so the long generated SelectorFamilyKeys can be matched with just the manually entered bit.

showConnected will show nodes which are connected to those in the keys array as well (defaults to true)