The design board
Make a design board of live frames, components, stickies and cards on the Studio home, and edit it together in real time.
In the pilot
The design system module is in the pilot. It is on for pilot orgs first. An org admin can tell you whether yours has it.
A design board is a free canvas in the Studio. You place live frames of prototypes and of your system's stories, components from a system's catalogue, stickies and cards for tasks and specs. Everyone with edit access works on it at the same time and sees each other's cursors.
Before you start:
- Boards need the
studiomodule. The palette's components come from design systems, which need thedesignmodule. - Staff can stop boards with the
boardkill switch. Thestudioandlive_editingswitches stop them too. The board then says "Live boards are off for now." See kill switches and modules. - Boards work in the web app and the desktop app.
The product's Board tab is the work board for tasks, not this one. See workflows and the board for that.
Make a board
Any org member can make a board. Guests can't.
Open the Studio home, or a product's Studio list.
Press New design board.
Type a title, up to 200 characters. Pick a product, or No product. On a product's list, that product is already picked.
Press Make board. The board opens.
To rename a board, press the pencil beside its title. If you may share the board, press Share to give people, teams or products access. A board has no versions and no share link.
Who can open and edit a board
A board is a Studio artifact, so it follows the same access as a prototype. People with edit or full access edit it. People with view or comment access open it read-only: they can pan, zoom, select and open frames, but they can't change anything. The header shows a badge with the reason, such as "You can view this board".
Someone without access sees "You don't have access to this board". If your access is removed while the board is open, it closes with "This board is gone, or you no longer have access."
On a phone or a touch-only tablet, the board opens read-only with "Open on a computer to edit".
Add things to the board
The toolbar holds Palette, Add sticky, Add card, Bring to front, Delete, Zoom out, Zoom in and Fit.
Components, stories and prototypes
Press Palette.
On Components, pick a System and a Release, or Unreleased. You see the systems your board's product uses. With none declared, you see every system you can read.
Drag a component or one of its stories onto the board. Or focus it and press Enter to place it in the centre of your view.
On Prototypes, drag a prototype to place a live frame of its latest version. Your board's product comes first.
A component shows its name and status. A story is a live frame from your system's Storybook, labelled latest while it runs. When the palette shows "Stories: not hosted" or "Stories: host not approved", the system's Storybook isn't served from an approved host yet. An admin sees a link to Frame settings.
Select a frame to show its controls. Pick a Device or Bare, press Rotate on devices that turn, or press Open to see the prototype or story on its own.
Stickies
Press Add sticky. A yellow sticky appears in the centre of your view, ready to type in. A sticky holds plain text, up to 2,000 characters. If two people type in one sticky at once, the last one wins.
Cards for tasks and specs
Press Add card and pick one of the board product's tasks, or a document under a task, such as its spec. The card shows the title and status, and updates when they change. Each person sees a card through their own access: one they can't read shows No access.
Move around the board
- Drag the canvas to pan. Scroll or use Zoom in and Zoom out. Fit shows every item.
- Drag items to move them, or select them and use the arrow keys: 8 px a press, 40 px with Shift.
- Delete or Backspace removes the selection. Escape clears it. Bring to front puts the selection on top.
- Tab to an item and press Enter to select it.
Why frames go still
Only a few frames run at once. A frame is live when it is in view and you are zoomed in to at least 35%. Up to 16 frames are live at a time, the ones you touched most recently first. Zoom out further and frames turn into cards with their name and an Open link. Zoom back in and they come alive again.
A frame that doesn't load within 5 seconds also shows as a card, never as a broken page.
Edit together
Everyone editing the board sees the others live:
- Each person's cursor moves in their own colour with their name.
- What each person selects is outlined in their colour.
- The Here now row in the header lists everyone on the board, you first.
- Press a name in Here now to jump to that person's view.
Changes from different people merge. When two people move the same item, the last move wins. A delete wins over a move.
People who can only view are not listed in Here now, but they see everyone who edits.
When something goes wrong
- "Can't reach the board. Retrying…" You are offline. The board stays read-only until it reconnects.
- "This board is full: 2,000 items" Remove items to add more.
- "2 items this version can't show" Someone used a newer app. Update yours.
- "This board holds something this version can't read. It is read-only." Update the app.
To review a design change on live frames instead, see review on live frames. For sharing other Studio work, see Studio share and review.
Something wrong or missing? Suggest a change
X-ray and conformance
Label every element of a page in the desktop browser by design system, file a one-off as a request, and add a conformance block to a pull request.
For developers
A developer's path through EasyCode: sessions on your own harness, pick-up and hand-off, the kit, repo knowledge and workflows.