Skip to content

Show a screen with a sketch, a mockup or an image

Early in modeling you often need to show a screen before you have designed it. A screen on a slice can carry three kinds of visual, beside its real screen or instead of one:

Kind What it is Good for
Sketch A wireframe of boxes, pen strokes and labels that you draw in Studio. A quick idea in a workshop.
Mockup One or more pages of HTML and CSS that you write. A closer look at layout and wording.
Image A screenshot or a design export: PNG, JPEG, GIF or WebP, up to 5 MB. A design made in another tool.

The visual sits in the screen’s cell on the slice, in the row of the person the screen is for. The newest one shows there, and selecting it opens it larger. The screen also shows how many of each it has: Sketches, mockup pages and images.

You need a slice with a screen cell in the row of the person it is for.

  1. On the screen, select Add a sketch, mockup or image to the screen.

  2. Choose Draw a sketch. The description reads “Wireframe the screen with a pen, boxes and labels”.

  3. Pick a Drawing tool: Pen to draw freely, Box to drag out a rectangle, or Label to write text. For a label, type the Label text, then click where it goes on the Sketch canvas.

  4. Use Undo to take back the last stroke, or Clear to start again. Give the sketch a Title.

  5. Select Save.

  1. Select Add a sketch, mockup or image to the screen and choose Write a mockup page. It writes the screen “as an HTML and CSS page”.

  2. Type or paste your page into HTML and CSS. The Mockup preview shows how the page looks.

  3. Give it a Title and select Save.

  1. Select Add a sketch, mockup or image to the screen and choose Attach an image. The description reads “A screenshot or a picture of the screen”.
  2. Select Choose an image and pick a PNG, JPEG, GIF or WebP file of at most 5 MB. Other kinds of file are refused, and so is SVG.
  3. Select Save.

When the idea has settled, Convert to prototype writes a real screen from the visual. It is available in the sketch, the mockup page and the image.

  • The conversion is done by your organization’s screen design agent, so one has to be set up. See Work with AI.
  • The new screen is checked before it is saved. If it does not check out, Studio tells you why and changes nothing.
  • If the slice already has a screen, Studio asks Replace the prototype? first. The visual is kept either way.

After the conversion, continue in the screen editor.

Open the visual and select Remove. Studio asks you to confirm with Remove from the screen.

Visuals travel with the model. When you export the board as Screenplay files, every visual is saved as a line on its screen and a file beside it. Importing those files brings the visuals back onto the same screens. If an imported model names a file that the archive does not carry, Studio reports it and finishes the rest of the import. Importing the same model again updates the visuals; it does not add copies.

Keeping a board in sync with Git carries them too. For the files themselves, see Screenplay files.

The visual shows in the screen’s cell, and the count of sketches, mockup pages and images on the screen has gone up by one.