mockup # 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 ![Mockup browser review: choose a layout and pin a spacing change before iteration](assets/browser-review.png) 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 ### Setting names | Setting | Environment | | --- | --- | | `mockup.openBrowser` | `PI_MOCKUP_NO_OPEN` |