Review visual ideas with Pi before committing to an interface direction.
Pi can present one to four interactive HTML mockups, including multipage flows, collect your choice, notes, and pinpoint annotations, then use that feedback in the next iteration.
Pi can also render private previews first and refine the mockups before you ever see a review.
Nothing to invoke.
Ask Pi for a visual comparison or an interactive mockup review.
Pi loads the HTML guidance skill before composing mockups.
Show me two mobile checkout layouts and let me choose one.
When Pi offers the review, choose Open interactive browser.
Select an option, add notes or annotations where needed, then accept it or ask Pi to iterate.
Pi receives your selections and feedback and can present a revised version in the same review.
Browser example
Ask: Show two desktop checkout layouts, let me choose one, and let me point out spacing changes.
In browser, select preferred option, choose Pin note, then click exact place needing a change.
Write feedback in pin or Global notes, then choose Iterate.
Pi receives selected option IDs, notes, and normalized pin positions, then replaces review with revised options in same browser tab.
Compare revision, then choose Accept when direction is settled.
Flows
An option can be a navigable flow of two to twelve pages instead of a single screen.
The reviewer sees numbered tabs ("1 · Cart"), prev/next buttons, and arrow, Home, End keyboard navigation.
Pins land on the page that was active when pinned.
Show the checkout as a three-step flow; I want to pick the flow, not each screen.
Agent previews
With preview: true, Pi renders options and pages headlessly for its own inspection without opening a browser.
Each call returns at most eight screenshots to Pi.
Previews require Playwright's matching Chromium browser; install it once with mise run //extensions/mockup:install-browser from the checkout.
Missing browser → actionable preview error; interactive review remains available.
Fragment network requests are blocked during previews; use self-contained assets.
Browser behavior
The review opens in your browser by default.
Set mockup.openBrowser to false when you prefer to open the URL yourself.
PI_MOCKUP_NO_OPEN=1 also prevents automatic browser opening for that Pi run.
The review page is served locally.
Privacy and control
Mockup reviews are temporary visual conversations with Pi.
Do not put secrets into mockup content or feedback.
Mockup HTML runs in your browser and may make network requests; local serving is not a sandbox.
Avoid untrusted HTML and sensitive browser sessions.
Mockup itself does not write project files.
Reference
Setting names
Setting
Environment
mockup.openBrowser
PI_MOCKUP_NO_OPEN
<img src="assets/banner.svg" alt="mockup" height="70">
# Mockup
Review visual ideas with Pi before committing to an interface direction.
Pi can present one to four interactive HTML mockups, including multipage flows, collect your choice, notes, and pinpoint annotations, then use that feedback in the next iteration.
Pi can also render private previews first and refine the mockups before you ever see a review.
[Installation](../../README.md#install)
## Use it in Pi
Nothing to invoke.
Ask Pi for a visual comparison or an interactive mockup review.
Pi loads the [HTML guidance skill](guidance/mockup-html/SKILL.md) before composing mockups.
```text
Show me two mobile checkout layouts and let me choose one.
```
When Pi offers the review, choose **Open interactive browser**.
Select an option, add notes or annotations where needed, then accept it or ask Pi to iterate.
Pi receives your selections and feedback and can present a revised version in the same review.
## Browser example

Ask: `Show two desktop checkout layouts, let me choose one, and let me point out spacing changes.`
In browser, select preferred option, choose **Pin note**, then click exact place needing a change.
Write feedback in pin or **Global notes**, then choose **Iterate**.
Pi receives selected option IDs, notes, and normalized pin positions, then replaces review with revised options in same browser tab.
Compare revision, then choose **Accept** when direction is settled.
## Flows
An option can be a navigable flow of two to twelve pages instead of a single screen.
The reviewer sees numbered tabs ("1 · Cart"), prev/next buttons, and arrow, Home, End keyboard navigation.
Pins land on the page that was active when pinned.
```text
Show the checkout as a three-step flow; I want to pick the flow, not each screen.
```
## Agent previews
With `preview: true`, Pi renders options and pages headlessly for its own inspection without opening a browser.
Each call returns at most eight screenshots to Pi.
Previews require Playwright's matching Chromium browser; install it once with `mise run //extensions/mockup:install-browser` from the checkout.
Missing browser → actionable preview error; interactive review remains available.
Fragment network requests are blocked during previews; use self-contained assets.
## Browser behavior
The review opens in your browser by default.
Set `mockup.openBrowser` to `false` when you prefer to open the URL yourself.
`PI_MOCKUP_NO_OPEN=1` also prevents automatic browser opening for that Pi run.
The review page is served locally.
## Privacy and control
Mockup reviews are temporary visual conversations with Pi.
Do not put secrets into mockup content or feedback.
Mockup HTML runs in your browser and may make network requests; local serving is not a sandbox.
Avoid untrusted HTML and sensitive browser sessions.
Mockup itself does not write project files.
## Reference
<!-- config:start -->
### Setting names
| Setting | Environment |
| --- | --- |
| `mockup.openBrowser` | `PI_MOCKUP_NO_OPEN` |
<!-- config:end -->