@castore/lib-react-visualizer
v2.3.1
Published
React component to visualize, design and manually test Castore event stores and commands.
Downloads
103
Readme
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 JSONSchemaCommand
s 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>