Documentation
Everything you need to know about using Whiteboard.
Getting Started
Sign in at /login. Once authenticated you land on the Board Hub — your central dashboard for all boards and workspaces.
Click New Board to create your first canvas. Boards are auto-saved as you work; you don't need to press save manually.
Canvas Tools
The toolbar runs along the left side of the canvas. Click a tool or press its keyboard shortcut to activate it.
Shapes
Rectangle (R), Circle (O), and Diamond (D) are the core shapes. Click and drag on the canvas to draw. After placing, use the style panel on the right to change fill colour, stroke colour, and stroke weight.
Text
Press T and click anywhere to place a text node. Double-click an existing text node to edit it inline. Font family and size are adjustable in the style panel.
Connector
Press C then click a source shape anchor point (shown in blue on hover), then click a target anchor point. Connectors are bezier curves and update automatically when shapes are moved.
Pen / Freehand
Press P and draw freely. Strokes are smoothed automatically. Select a pen stroke to adjust its colour and weight in the style panel.
Images
Drag an image file from your desktop directly onto the canvas to place it. Images can be resized by dragging their corner handles.
Icons
Click the icon tool in the toolbar to open the icon picker. Search across AWS, Azure, GCP, and general icons. Click an icon to place it. Resize and label icons the same as any other node.
Selection & Multi-select
Press V to switch to the select tool. Click to select a single node. Drag a selection box to select multiple nodes at once. Hold Shift and click to add individual nodes to the selection.
Collaboration
Inviting collaborators
From the canvas header, click Collaborators. Enter a team member's email address and choose their role:
- Editor — can view and edit the canvas.
- Viewer — can view the canvas but cannot make changes. The toolbar is hidden and save is disabled.
Changing a collaborator's role
Open the Collaborators panel and use the role dropdown next to each person's name. Changes take effect immediately.
Removing a collaborator
Click the remove button next to a collaborator in the panel. They will no longer see the board in their Board Hub.
Real-time sync
When multiple editors have the same board open, canvas changes are broadcast instantly over WebSocket. A CRDT merge ensures that concurrent edits never overwrite each other.
Workspaces
Workspaces let you organise boards for a team. A workspace has its own board list and member roster.
Creating a workspace
From the Board Hub sidebar, click the + icon next to the Workspaces heading. Enter a name and submit. The new workspace appears in the sidebar immediately.
Switching workspaces
Click a workspace name in the sidebar to switch to it. The main area shows that workspace's boards. Click Personal to return to your own boards.
Managing a workspace
Click the cog ⚙ icon next to a workspace name to open its admin page. From there you can:
- Invite members by email
- Change a member's role (owner / admin / member)
- Remove members
Workspace boards
Boards created inside a workspace are only visible to workspace members. They do not appear in any member's personal board list.
Keyboard Shortcuts
| Shortcut | Action |
|---|---|
V | Select tool |
M | Marquee select |
R | Rectangle |
C | Circle |
D | Diamond |
T | Text |
P | Pen / freehand |
S | Sticky note |
Shift+1 | Zoom to fit |
Escape | Deselect / switch to Select tool |
Delete / Backspace | Delete selected nodes |
Ctrl/⌘ + Z | Undo |
Ctrl/⌘ + Shift + Z | Redo |
Ctrl/⌘ + C | Copy selected |
Ctrl/⌘ + V | Paste |
Ctrl/⌘ + D | Duplicate selected |
Space + drag | Pan canvas |
Scroll wheel | Zoom in / out |