A collaborative Event Storming whiteboard application built with TL Draw, React, TypeScript, and Vite. Perfect for Domain-Driven Design (DDD) workshops and team brainstorming sessions.
- 📅 Events (Orange) - Things that happened in your domain
- ⚡ Commands (Blue) - Actions that trigger events
- 📦 Aggregates (Yellow) - Domain boundaries and consistency boundaries
- 👤 Actors (Pink) - Users, personas, or external systems
- 📊 Read Models (Green) - Views and queries
- 🔥 Hot Spots (Red) - Areas of uncertainty or confusion
- 👥 Real-time multiplayer - Multiple users can work simultaneously
- 🖱️ Live cursors - See where team members are working
- 👀 User presence - Know who's on the board
- 🔄 Instant sync - Changes appear in real-time across all clients
- ✏️ Editable sticky notes - Double-click to edit text
- 🎨 Custom shapes - Color-coded sticky notes for each type
- 🔍 Zoom and pan - Navigate large canvases easily
- 🔄 Undo/redo - Full history support
- 📐 Drawing tools - Use standard TL Draw tools for arrows, connectors, etc.
- Node.js 18+ and npm (or yarn/pnpm)
- Install dependencies:
npm install- Start the development server:
npm run dev- Open your browser and navigate to the URL shown in the terminal (typically
http://localhost:5173)
To create separate boards or join specific sessions, add a room query parameter:
- Default:
http://localhost:5173 - Custom room:
http://localhost:5173?room=my-session-id
Share the same room URL with your team to collaborate on the same board!
npm run buildThe built files will be in the dist directory.
npm run preview- Create Sticky Notes: Click on any sticky note type in the "Event Storming Tools" panel on the left
- Edit Text: Double-click on any sticky note to edit its text
- Move & Resize: Click and drag to move, use handles to resize
- Connect Ideas: Use the drawing tools (arrows, lines) to connect related events and commands
- Collaborate: Share the room URL with your team - they'll see changes in real-time!
- Start with Events: Begin by identifying domain events (orange notes)
- Add Commands: Identify what triggers each event (blue notes)
- Define Aggregates: Group related events and commands (yellow notes)
- Identify Actors: Who or what initiates commands? (pink notes)
- Mark Hot Spots: Flag areas that need discussion (red notes)
- Create Read Models: Define views for queries (green notes)
.
├── src/
│ ├── App.tsx # Main application component
│ ├── EventStormingBoard.tsx # Event Storming board with collaboration
│ ├── shapes/
│ │ └── EventStormingSticky.tsx # Custom sticky note shape component
│ ├── main.tsx # React entry point
│ └── index.css # Global styles
├── index.html # HTML entry point
├── package.json # Dependencies and scripts
├── tsconfig.json # TypeScript configuration
├── vite.config.ts # Vite configuration
└── README.md # This file
The board uses a room ID for collaboration. By default, it uses 'event-storming-default' or reads from the URL query parameter ?room=your-room-id.
To change it programmatically, modify src/App.tsx:
<EventStormingBoard roomId="my-custom-room" />Edit src/shapes/EventStormingSticky.tsx to add new sticky note types or modify existing ones.
useSyncDemo) is for development only and data persists for 24 hours. For production, you'll need to:
- Self-host the TL Draw sync server, or
- Integrate with a real-time backend like Liveblocks, or
- Use your own WebSocket server
See the TL Draw collaboration docs for production setup.