Build behaviour (Flow-Driven Development)
Whiteboards
Sketch a journey with shapes and arrows, get it reviewed and approved, then turn it into work and track what each shape became.
Open Whiteboards in the appWhat a whiteboard is for
A whiteboard is where a journey starts: a sketch of the steps, questions, screens and systems, joined by arrows. Nothing on it runs or is tested. Its job is to agree on what to build before anyone builds it. Once it is approved and published, it is turned into work: each shape links to the system, API, flow, logic, requirement or ticket it turned into.
Open Whiteboards under Behaviour in the sidebar. The list has three tabs: For my review, My whiteboards and Published. The badge on the sidebar item counts whiteboards waiting for your review.
Everything a whiteboard can do
Each line links to the part of this guide that explains it.
- Draw with 14 shapes (Start, End, Step, Decision, Screen, Wait, Actor, System, Data, Note, Text, Lane, Frame and Image), joined by arrows. Start blank, from a template, or by typing the steps as text. Draw one
- Arrange shapes: line them up, spread them evenly, bring to front or send to back, duplicate, nudge with the arrow keys, and Tidy up the whole journey. Arrange shapes
- Group, lock and frame shapes so they move together or stay put, with guide lines that snap shapes into line as you drag. Group and lock shapes
- Style the text (size, bold, alignment), colour shapes, and choose each arrow's route, line, weight, arrowheads and colour. Style the text and lines
- Notes and labels on shapes and on arrows, shown to everyone who reads the whiteboard.
- Pictures: paste, drop or choose mock-ups and screenshots, with a description for screen readers. Pictures
- Screens from the Screen Builder as pictures, with arrows where their buttons lead; Inspect a widget's size, styles and code. Screens on a whiteboard
- Move around a big whiteboard: zoom, Fit the whiteboard, the map in the corner, and Find…. Move around the whiteboard
- Edit together live: everyone's changes and pointers show at once, undo takes back only your own changes, and it saves by itself. Edit together
- Co-editors: ask teammates to draw a whiteboard with you, a draft too. Co-editors
- History of every save: look back at any kept version, see what each save changed, and bring one back. History
- See who's here and follow them, or bring everyone to the step you are presenting. Who's here
- Review and publish: pick approvers, collect approvals or requests for changes, and see what changed since the last round. Review and publish
- Comments on a shape, an arrow or the whole whiteboard, with replies, resolve and reopen; a comment can become a ticket that resolves it when done. Comments, paths and presenting
- Paths: every way from a Start to an End, likely mistakes, your own path names, and each path copied as a test case.
- Present full screen, one path at a time.
- Download a PNG, an SVG or a PDF (whole whiteboard, one page per frame, or one page per path). Download a PDF
- Share outside the organization with a read-only link that expires and can be revoked. Share outside the organization
- Turn it into work: link each shape to the system, API, flow, logic, requirement or ticket it became, and track build progress. Turn it into work
- Tickets and chat from any shape or path, with a review channel and a public channel for each whiteboard. Tickets and chat
- Keyboard shortcuts for nearly everything. Keyboard shortcuts
Draw one
- Press New whiteboard, give it a name and say what it's for.
- Under Start from, pick Blank, From a template or Text. Templates come in two groups: Your organization (the ones your team saved) and From the Store (Login, Sign up, Password reset, Checkout and more).
- Press Create and open. A new whiteboard opens ready to draw; later, it opens read-only and Edit changes it.
- Add shapes from the palette on the left: Start, End, Step, Decision, Screen, Wait, Actor, System, Data, Note, Text, Lane, Frame and Image. You can also drag them onto the canvas, right-click the canvas, or double-click empty space for a Step.
- To connect two shapes, drag the + port of a selected shape onto another. Drop it on empty space to create a new shape that is already connected.
- Press Done to save and stop editing, or Save (
Ctrl+S) to save and keep going.
Your own templates. On any whiteboard, More actions → Save as template… keeps its steps and arrows as a template everyone in the organization can start from. Positions, colours, lanes, frames, pictures and free text aren't kept: a new whiteboard lays the steps out again. Anyone who can edit whiteboards saves one; its creator, or someone who can publish whiteboards, renames or deletes it from the template's tile under New whiteboard → From a template.
With Text you write the journey one step per line. End a line with ? to make it a question, indent Answer -> step lines under it for the answers, and start a line with Start:, End:, Screen:, Wait:, System:, Actor: or Data: to pick the shape. A preview shows as you type. While editing, Add from text… adds more steps the same way.
Double-click (or Enter) edits a label. Right-click a shape or an arrow for Add note…, colours and order. Drag the + on a selected arrow to bend it; Reset the route straightens it. Tidy up lays the steps out left to right: the main path runs along one line, other answers branch off above or below it, and an arrow that goes back runs around the steps instead of through them. Undo takes it back.
Arrange shapes
While you edit, select shapes and use the right-click menu or the Details tab:
- Line them up. With two or more shapes selected, Details → Align lines up their left edges, centres across, right edges, top edges, centres down or bottom edges.
- Spread them out. With three or more, Spread across and Spread down leave the same gap between each.
- Order. Bring to front and Send to back decide which shape is drawn on top.
- Duplicate. Duplicate (
Ctrl+D) makes a copy next to the original. - Nudge. The arrow keys move the selected shapes a small step; hold Shift for a bigger one.
- Tidy. Tidy them up lays out just the selected shapes; Tidy up on the canvas lays out the whole journey.
- Arrows. Enter edits the label of the selected arrow. Right-click an arrow for Reverse, which swaps its direction, and Reset the route.
- Copy, cut and paste.
Ctrl+C,Ctrl+XandCtrl+Vwork between whiteboards; the arrows between copied shapes come too.Ctrl+Aselects everything.
Group and lock shapes
- Group. Select two or more shapes and press
Ctrl+G(or Group on the Details tab or the right-click menu). Clicking any shape in a group then selects all of it, and dragging moves the whole group. A dashed box shows the group. Double-click a shape to work on just that one.Ctrl+Shift+Gor Ungroup takes the group apart. Copies of a group are a new group of their own. - Lock in place. Press Lock in place (
Ctrl+Shift+L) to pin a shape where it is. You can't move, resize or delete it until you press Unlock, but you can still change its label and colour and comment on it. A padlock shows on it while you edit. Lock big lanes and frames so they don't move when you drag inside them: a drag that starts on a locked lane selects what's inside the box you draw. - Frame them.
Ctrl+Alt+Fputs a titled frame around the selected shapes.
While you drag or resize a shape, red guide lines show when its edge or centre lines up with another shape, and it snaps to them.
Style the text and lines
Select a shape to style it on the Details tab:
- Text. Pick a size (S, M, L, XL), make it bold, and align it left, centre or right. With several shapes selected, the style applies to all of them.
- Colour. One colour per shape. The fill is a light tint of it, so the words stay easy to read.
Select an arrow to choose its Route (elbow, straight or curved), Line (solid, dashed or dotted), Weight (thin, regular or bold), its arrowheads and its colour.
Pictures
Add mock-ups, screenshots and diagrams to a whiteboard while you edit it:
- Paste. Copy a picture anywhere, or take a screenshot, then click the canvas and press
Ctrl+V. It lands where the pointer is. - Drop. Drag picture files from your computer onto the canvas.
- Choose. Click Image in the palette, or right-click the canvas and choose Add a picture….
PNG, JPEG, GIF and WebP pictures work, up to the plan's size for one file (10 MB on Free; see Plans and billing). Very large pictures are scaled down to 2400 pixels on their longest side. Dragging a corner keeps a picture's proportions; hold Shift to stretch it, and Back to its own proportions undoes a stretch. Give each picture a Description on the Details tab: screen readers read it out, and Find… searches it.
Pasting words that weren't copied from a whiteboard adds them as a Text shape. Shapes copied with Ctrl+C paste as shapes, arrows included.
Pictures are seen by the same people as the whiteboard, and are deleted with it. PNG and SVG downloads include them.
Screens on a whiteboard
Put the screens of a Web frontend or Mobile app on a whiteboard to talk a journey through with how it really looks:
- While you edit, click Screen picture in the palette, right-click the canvas and choose Add screens…, or use More actions → Add screens….
- Pick the system and tick its screens.
- Pick the width: Phone (390 px), Tablet (768 px) or Desktop (1200 px). With the layout around each screen adds its header, menu and footer.
- With two or more screens, Draw arrows where buttons and links lead between them joins them, each arrow named after its buttons (a screen that opens another by itself says *When it opens*).
- Press Add screens. The pictures go side by side, all selected, and one undo takes them back.
Each is a picture of the screen as it was saved, as it opens: starting values and nothing typed in. It stays as it was: when the screen changes, the picture says *changed since this picture* on its Details tab and on the review badge, and Refresh picture (also in its right-click menu) makes it again, in the same place and width. Open the screen opens it in the Screen Builder.
Inspect. Right-click a screen picture and choose Inspect, or press Inspect on its Details tab. Point at a widget to outline it and click to pin it: the panel shows its size, its place, the space to its parent's edges, its text and the styles the browser worked out, with the theme's names (such as *colors.primary*) where a value is the theme's. Hold Alt and point at another widget to see the distance between them. CSS, HTML, Angular and React copy its styles and its code as the screen's export writes it now; a widget no longer on the screen says so. Copy theme as CSS copies the theme's colours, font, corners and spacing as CSS variables.
Move around the whiteboard
- Pan and zoom. Drag empty space to pan, or Shift-drag to draw a box that selects the shapes inside it; use the mouse wheel or the Zoom in and Zoom out buttons in the corner to zoom.
- Fit. Fit the whiteboard shows all of it at once.
- The map. The small map in the bottom-left corner shows the whole whiteboard; click or drag in it to go there. The map button next to the zoom buttons hides or shows it, and your browser remembers the choice.
- Find. Find… (
Ctrl+F) searches labels, notes and picture descriptions, and moves to each match. - Palette search. While editing, press
/to search the shapes palette.
Download a PDF
More → Download PDF… makes a PDF with a cover (the name, the status, the approvers and what they decided), then the pages you pick:
- The whole whiteboard on one page.
- One page per frame, in reading order.
- One page per path, each with its path standing out and its steps listed below. Use it as a handout for a review.
Tick the box to add the open comments at the end. The drawings in the PDF are sharp at any zoom, and you can select and search their text.
Share outside the organization
People who may publish whiteboards can give someone outside the organization (a client, a stakeholder) a read-only link to a published whiteboard:
- Open the whiteboard and look at the Details tab with nothing selected.
- Under Share outside the organization, pick how long the link works (7, 30 or 90 days) and press Make a link. The link is copied. Copy it now: it isn't shown again.
- Send it. The person sees the whiteboard as it is saved, can pan, zoom and download it as a PDF or PNG, and sees nothing else in the organization.
The list under it shows each link, who made it, until when it works and how often it was opened. Revoke stops a link at once. A link also stops working when the whiteboard goes back to a draft, when it is deleted, or when an admin turns off Allow share links in Settings → General.
Who's here
The pictures at the top of a whiteboard show who else has it open. A pencil means they are editing; a play sign means they are presenting.
- Follow someone. Click their picture. While they present, you see the same path and step as they move. Otherwise your view moves with theirs; pan or zoom yourself, or press Stop, to stop following.
- Let others follow me. People can follow you only while you present, or after you press the eye button next to the pictures.
- Bring everyone here. While presenting, press Bring everyone here. Everyone with the whiteboard open is asked to follow you; the question stays until they press Follow or close it. When you end, the people following are told you stopped presenting.
Only the people who can see the whiteboard see who has it open.
Edit together
Everyone who may edit a whiteboard can edit it at the same time. Press Edit; when someone is already editing, the button says Join editing.
- Live. Each change shows for everyone at once, also for people who are only viewing. While you edit, you see the others' pointers with their names.
- Undo is yours.
Ctrl+Ztakes back only your own changes, never someone else's. If two people change the same thing at the same moment, the last change wins. - Saving. The whiteboard saves by itself a few seconds after the last change; the chip next to the title says *saved* or *unsaved*. Save (
Ctrl+S) saves right away. When the last person editing presses Done or leaves the page, the rest is saved. - After 15 minutes without a click or a key, your editing stops and your changes are saved.
- Who may edit: a draft is drawn by its creator and co-editors, a whiteboard in review is frozen, and a published one is edited by its creator, co-editors and approvers.
Co-editors
Like sharing a board with *can edit*, the creator can ask teammates to draw a whiteboard with them. Press Co-editors in the header, add people and press Save. Only people whose role can edit whiteboards are offered, and never the whiteboard's approvers. A whiteboard has at most 20 co-editors.
- Co-editors see the whiteboard from the start, even while it is a draft, and find it under My whiteboards. They are told when they are added.
- They edit it with you, live, and can Submit for approval… or withdraw it. While it is in review it is frozen for everyone.
- Once it is published they keep editing it, like the approvers. They can also resolve review comments.
- They can't approve it: someone who drew it doesn't review it. Publishing without a review, choosing the co-editors and deleting the whiteboard stay with the creator.
- Everyone else who can see the whiteboard can open Co-editors to see who draws it.
Review and publish
A draft is yours and your co-editors' alone. Approvers see it once you submit it, and everyone sees it once it is published.
- Press Submit for approval….
- Under Approvers, pick 1 to 20 people. Only people whose role can edit whiteboards are offered, and only they can approve or ask for changes. Under Approved when, choose All approvers approve or At least a number.
- Approvers press Approve or Ask for changes… (with a comment). Asking for changes sends it back to you; fix it and press Resubmit….
- Once approved, the creator or an approver who may publish presses Publish.
Project owners can choose No approval needed under Approval and publish a draft straight away. Everyone is told it was published without a review.
On every round after the first, a banner counts what changed. Show changes marks new shapes green, changed ones amber and removed ones as dashed ghosts, and the Review tab lists each change.
History
Every save is kept for a while: each save of the last hour, then one an hour for a day, then one a day, up to 200 versions. Open the History tab to see them.
- Move the slider, or pick a version from the list. The canvas shows that version read-only, with what that save changed marked the same way as Show changes: new shapes green, changed ones amber, removed ones as dashed ghosts.
- Back to now shows the whiteboard as it is again. Leaving the tab does the same.
- Restore this version brings that version's shapes and arrows back. It starts editing if you weren't, and it is one change like any other: everyone editing sees it, it saves by itself, and Undo takes it back. The whiteboard's name and path names stay as they are.
Anyone who can see the whiteboard can look through its history. Restoring needs the same rights as editing.
Comments, paths and presenting
- Comments. Right-click a shape or an arrow and choose Comment…, or right-click empty space for Comment on the whiteboard…. Shapes with open comments show a blue badge. Replies, resolve and reopen are on the Comments tab. Publishing with open comments asks first, with Publish anyway.
- Paths. The Paths tab lists every way from a Start to an End, with the answer taken at each question. Worth a look lists likely mistakes, such as a step that leads nowhere or a question with one answer. Copy as test case (Given/When/Then) copies a path as Given / When / Then; Copy as test cases copies them all. These make a good first draft of your test cases.
- Renaming a path. A path is named by where it ends and the answers it takes. To give it your own name, press Edit, open the path in the Paths tab and type in its Name field. Clear the field to go back to the automatic name. Two paths can't have the same name. The name shows when you present, copy a test case or make a ticket, and is saved with the whiteboard. It stays with the path when you relabel its steps, but goes away if you redraw the path through other shapes.
- Outline. At the bottom of the Paths tab, every shape in reading order. It is the keyboard and screen-reader way around the canvas.
- Present. Present opens full screen on Show all, the whole whiteboard with nothing faded (where the browser doesn't allow full screen, it fills the window). Press →, the first path's button at the bottom, or pick a path in the list to walk through one path at a time: the way so far stands out and the rest fades. Present on a path in the Paths tab starts on that path. Arrow keys, Space or the buttons at the bottom move; Esc, or leaving full screen, ends.
- Find. Find… (
Ctrl+F) searches labels and notes.
Turn it into work
After publishing, the whiteboard tracks what each shape became.
- Select a shape and open the Links tab, or right-click it and choose Link to what it became….
- Link it to a system, API, flow, logic, requirement or ticket, and set its Build status to To do, In progress or Done.
- Press Build progress to badge every shape with its state. The header shows how many shapes are done.
- When development starts, press Start building. When everything is done, press Mark done.
Is it still true? Once shapes are linked, the whiteboard keeps an eye on what they became. A step is out of date when its system or logic was deleted, its API was deleted or deprecated, its API's contract is broken, its flow's test cases fail, or its ticket was closed without being done. Each such shape gets an amber badge, the header says how many steps are out of date, and the Links tab lists them (with nothing selected); each one leads to its shape. Under Drawn vs built, the same tab lists the steps not built yet (linked to nothing) and what was built for steps that are no longer drawn.
Editing a published whiteboard keeps it published, but marks it as changed after its approval until the creator or an approver confirms the changes. While a whiteboard is in review, its creator can take it back with Withdraw to draft in the More menu. Reopen takes a whiteboard that is in development or done back to published.
Tickets and chat
Tickets work on published whiteboards only, so a private draft's name never reaches the board.
- Right-click a shape and choose Create ticket…. The ticket links to the shape and the whiteboard, and the shape moves to In progress.
- Select several shapes to create one task each in one step.
- A dot marks shapes with open tickets. The Tickets tab lists the whole whiteboard's tickets.
- On a path, Create ticket makes one ticket linked to every step. Once it is made, the path shows that ticket instead, until the ticket is done.
- On a comment in the Comments tab, Create ticket makes a task linked to the shape and the whiteboard, with the comment quoted in its description. The comment shows the ticket. When the ticket moves to a done column, the comment is resolved; when the ticket is reopened, the comment opens again.
When you submit, a private review channel opens for you and the approvers. Once published, the whiteboard gets a public channel, and each step of the review is posted there. Discuss in chat… on any menu opens a room with a mention of the shape; Copy mention copies one to paste anywhere. The Chat tab shows the latest messages. See Chat and Board.
Keyboard shortcuts
On a Mac, use Cmd where it says Ctrl.
More
The More menu (⋯ in the header) has Download PNG, Download SVG, Download PDF…, Copy link, Take the 1-minute tour and How to use whiteboards, which opens this guide. While editing it also has Add from text…, Add a picture… and Tidy up. For full examples, see Draw a whiteboard, Review one and Turn one into work.
Sticky notes
A sticky note is a short note on the canvas, for you or for everyone. Anyone in the organization or project can add one, viewers included. A sticky note is never part of what it sits on: it has no versions, it isn't reviewed, and Draft mode and draft-first publishing don't hold it back.
- Add one. Press the sticky note button with the zoom buttons and choose Add sticky note, or right-click an empty part of the canvas and choose Add sticky note here. Type, then press Save (or
Ctrl+Enter). An empty note goes away. - Who sees it. A new note is Only me: nobody else ever sees it. Choose Organization before saving, or later from the note's menu, and everyone who can open the whiteboard sees it with your name on it.
- Fold it. The fold button turns a note into a small icon; click the icon to open it again. Folding is yours alone: a shared note you fold stays open for everyone else, and stays folded on your other devices.
- Change it. Only the person who wrote a note changes it. Double-click the text (or choose Edit) to edit it, drag it by its top bar to move it, or nudge it with the arrow keys. Its menu also has the colours.
- Delete it. Delete your own from its menu, and Undo brings it back for a few seconds. Someone who may edit the whiteboard can also delete a shared note left by someone else, after a confirm.
- Hide them. Hide sticky notes in the same button hides every note on whiteboards for you, until you choose Show sticky notes.
A sticky note is not the Note shape. The Note shape is part of the drawing: it is saved with it, reviewed and exported. A sticky note is yours or the organization's, on top of the drawing, at any stage of the review, and never in the history, the exports or a share link. Deleting the whiteboard takes its sticky notes to the trash with it, and archives its chat channels (its channel and its review channel; Unarchive brings one back). Anyone who has it open is told it was deleted.
Related
- Flow-Driven DevelopmentThe method behind Rabbinatix: describe how your software behaves as a flow you can run, prove it with test cases, then turn it into code.
- Requirements and coverageWrite requirements, link them to flows and test cases, and see which ones your runs prove. Follow any change to the flows it affects.
- The board and ticketsTrack work as tickets on one board: types, columns, tags and sprints, mentions that open the exact place, and the planning views.
- ChatTalk about systems and contracts in channels that know about them: live status cards, Rabbinatix posts when something breaks, threads, and messages that become tickets.
- Step-by-step examplesEvery click and value to build a login flow, a system map, logic and a whiteboard.
