@castore/lib-react-visualizer

React Visualizer

React component to visualize, design and manually test Castore event stores and commands.

Here is a hosted example, based on the docs code snippets about pokemons and trainers. You can find the related source code (commands & event stores) in the demo package.

📥 Installation

# npm
npm install --save-dev @castore/lib-react-visualizer

# yarn
yarn add --dev @castore/lib-react-visualizer

This package has @castore/core, @castore/command-json-schema and react (above v17) as peer dependencies, so you will have to install them as well:

# npm
npm install @castore/core @castore/command-json-schema react

# yarn
yarn add @castore/core @castore/command-json-schema react

👩‍💻 Usage

// ...somewhere in your React App
import { tuple } from '@castore/core';
import { Visualizer } from '@castore/lib-react-visualizer';

const MyPage = () =>
  <Visualizer
    eventStores={[
      eventStoreA,
      eventStoreB
      ...
    ]}
    // 👇 `tuple` is only used for type inference
    commands={tuple(
      commandA,
      commandB
      ...
    )}
    // 👇 Provide additional context arguments
    // (see https://github.com/castore-dev/castore#--command)
    contextsByCommandId={{
      COMMAND_A_ID: [{ generateUuid: uuid }],
      ...
    }}
  />

It will render a visualizer.

☝️ Warning

❌ This package is not an admin ❌

We are thinking about re-using some Components to develop an admin, but it is NOT an admin for now. It's main goal is to visualize, design and manually test your event stores and commands, as well as getting familiar with the event sourcing paradigm.

No connection to a DB or API is actually done. All the data is stored locally your web page, thanks to a ReduxEventStorageAdapter.

Also, the forms are generated with react-json-schema-form, so only JSONSchemaCommands are supported.

🎨 Unthemed component

The visualizer uses the MUI components library. You can customize its design by providing your own theme:

import { CssBaseline, ThemeProvider, createTheme } from '@mui/material';
import { UnthemedVisualizer } from '@castore/lib-react-visualizer';

const customTheme = createTheme({
  ...
})

const MyPage = () =>
  <ThemeProvider theme={customTheme}>
    <CssBaseline/>
    <UnthemedVisualizer ... />
  </Theme>