Skip to content

Add a screen to a slice

A screen shows what one person sees while a slice happens. A Shopper browsing the catalog sees the product list; the same Shopper sees the basket when they add an item. Adding a screen to the slice puts that picture next to the commands and read models it uses.

You can add a screen to a State Change slice, where the screen takes the fields of the command, and to a State View slice, where the screen shows what a read model holds. For the four kinds of slice, see Slices.

  • You need a board with a slice that has a command or a read model. See The event model board.
  • A screen belongs to the person it is for. Put the screen in that person’s row, such as the Shopper row of the Storefront.
  • A slice that is marked done or is under review cannot be changed. Its screen can be looked at, and the editor says so with Read only.
  1. On the slice, in the row of the person it is for, select Add UI prototype.

  2. Choose how to start:

    • From scratch starts with an empty prototype.
    • From template starts from a copy of an existing screen template. Pick one from the list. Templates are described in Screen templates.
  3. The screen appears on the slice as a small thumbnail. Select the wireframe icon, Open prototype editor, to work on it in the screen editor.

The screen editor open on the ProductBrowse screen of the Storefront board, with the parts of the screen listed on the left and the Inspector on the right
The ProductBrowse screen opened from its slice. The list on the left shows the parts of the screen.

A screen is only useful if someone can get to it. The slice shows where it comes from:

What the slice says What it means
own screen The slice has a screen of its own. When the screen opens in a dialog or a drawer, the slice says which.
no screen The slice has no screen. A command can still be run from a button on another screen.
issued from A button on another screen runs this command. It shows the screen, the place on it and the button, for example Product browse ▸ actions ▸ Add to basket.
issued nowhere No screen has a button that runs this command. The slice reads: “No screen and no hook. Add a button that issues it, or delete the slice.”

When a slice has a screen but no button anywhere opens it, the slice reads “Nothing opens this screen yet”. Select the hint to go to a screen where a button can be added.

The slice now shows a thumbnail of its screen. The editor lists the parts of the screen on the left: Opens & fits, Data context, Form, Outlets, Slots and Issued from.