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.

Sharing

Click Share in the canvas header to generate a shareable link. Choose between:

  • View only — anyone with the link can view but not edit.
  • Edit access — anyone with the link can make changes without signing in.

Share links work for anyone — the recipient does not need a Whiteboard account.

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

ShortcutAction
VSelect tool
MMarquee select
RRectangle
CCircle
DDiamond
TText
PPen / freehand
SSticky note
Shift+1Zoom to fit
EscapeDeselect / switch to Select tool
Delete / BackspaceDelete selected nodes
Ctrl/⌘ + ZUndo
Ctrl/⌘ + Shift + ZRedo
Ctrl/⌘ + CCopy selected
Ctrl/⌘ + VPaste
Ctrl/⌘ + DDuplicate selected
Space + dragPan canvas
Scroll wheelZoom in / out