Sign in to create and edit playbooks. Sign In Register

Create Mockups

ESM-6 Order: #6 Inception Has Dependencies

Updated 1 month ago

Guidance

Create Mockups (Prototyped Screens)

Objective

Build functional prototypes with representative mock data to validate UX before full implementation. Mockups are design reference — not connected to live data or production runtime.

Isolation

Serve mockups only in local/preview environments. They must be unreachable in test and production (not found / not mounted). Do not mix mockup routes or screens into the production application surface.

Mockup chrome (required on every screen)

Every mockup inherits a single shared shell. Do not duplicate mockup chrome inside individual screens.

Two signals are always present (except the full-bleed exception below):

1. Persistent mockup banner

A fixed banner at the top of the viewport states that the screen is design reference only and is not connected to live data.

  • Defined once in the shared shell.
  • Never removed or hidden on individual mockup screens.
  • Production chrome (nav, page header) sits below it.

2. Shared screen inventory

A single footer (or equivalent persistent index) lists every registered mockup screen. This is the canonical cross-link index for designers, reviewers, and agents jumping between prototypes.

Rules:

Rule Detail
Single source Maintain inventory links in the shared shell only — never add a second per-page inventory block.
Keep in sync When you add a mockup screen, add its inventory link in the same change.
Page-specific hints Optional suffix text (reset notes, store keys, and similar) attaches to the shared inventory. Do not fork the inventory.
Test hook The inventory root has a stable test id so agents and AT can find it.

Representative detail/edit screens that are reachable from list rows do not need inventory links unless they are primary entry points.

Full-bleed exception: A screen whose layout needs the full viewport height may hide the inventory. The banner stays visible.

Process

1. Register every screen

Every prototype in the Screen Flow is a registered mockup. Naming and routing follow the project's frontend conventions. The inventory in the shared shell is the canonical list — keep it in lockstep with registrations.

2. Use representative mock data

Mock data is hardcoded fixtures. Mockup screens have no live datastore access and no production auth checks. Cover the states the IA requires: loading, empty, error, success.

3. Build screens from the shared shell

Each screen extends the shared mockup shell (inherits banner + inventory).

  • Follow the IA Guidelines for layout, page headers, components, and test-id naming.
  • Visible title and subtitle use production copy — no Screen IDs and no “mockup” or storage jargon in the page header.
  • Screen traceability lives in metadata (screen-id slot → comment in the shell; test ids on containers and controls).
  • Mockup signaling is only the banner and the shared inventory. Interactive prototypes may append reset hints on the inventory, never in the page header.
  • Represent UI states; use semantic HTML, ARIA labels, and keyboard navigation.

4. Accessibility

  • Semantic structure (nav, main, section)
  • ARIA labels and roles on interactive elements
  • Keyboard navigation
  • Focus management for modals and alerts

Deliverables

  • ✅ Shared mockup shell with persistent banner and single screen inventory
  • ✅ Every Screen Flow prototype registered and linked from that inventory (no per-page duplicate inventories)
  • ✅ Representative mock data; no live datastore; no production auth
  • ✅ Production-real page headers; Screen IDs only in metadata / test ids
  • ✅ All required UI states (empty, loaded, error, success)
  • ✅ Accessibility (ARIA, semantic HTML, keyboard nav)
  • ✅ Mockups available in local/preview only; unreachable in test and production

Inputs

Read these before starting this activity. They are produced earlier in the playbook and are authoritative — raise a drift event instead of deviating.

  • User Journey (Document, Required) — produced by Define User Journey (#36).
  • IA Guidelines (Document, Required) — produced by Define Information Architecture (#37).
  • Screen Flow / Dialogue Map (Diagram, Required) — produced by Create Dialogue Maps (#38).
Details
Order:
#6
Phase:
Predecessor:
ESM-5 Write Feature Files
Created:
Apr 11, 2026
Last Updated:
Aug 19, 2026
Workflow
Envision the System

Turn your vision into formal design artifacts - user journey, screen flow, mockups, feature files, and design system

View Workflow
Assigned Agent

No agent assigned

Required Skills
Rules
Input Artifacts 3
Output Artifacts 2