Welcome

A floating panel over Ovvi's windows, 960 × 640 pt (scaled down as a whole to 80% of a smaller screen), centered: no title bar and no window buttons, rounded corners, the window's glass (Classic: opaque), a shadow. Drag its background to move it. It shows a few pages, one idea each, and the user turns them with Next and Back, → and ←, or Return. Skip (or Esc) closes it from any page; Get Started closes it on the last.

• When. On the first launch, alone: no window opens until it closes, and then the first one does (the new-window view). Windows macOS saved before (a reset leaves them, as their folder needs Full Disk Access) close at launch and connect to nothing, so macOS forgets them. Get Started, Skip or Esc mark it done (welcomeDone), and it never opens by itself again; a quit with it open does not, so the next launch shows it again. Settings ▸ General ▸ Welcome to Ovvi ▸ Show Welcome opens it again. It hides while Ovvi is not the active app, and the menu bar's keys do nothing behind it but Quit, Hide, Settings and Copy. scripts/e2e.sh marks it done for the UI tests, and a test that needs it passes -welcomeDone NO. defaults delete dev.ovvi.app.debug welcomeDone shows a first launch again in a Debug build.
• herdr. When This Mac has no herdr, one page installs it: one line on what it is, Install (the same install as the not-installed page, states), its progress, and a failure with Retry. Next waits until herdr is found; Skip still closes. With herdr installed the page is not there. The panel opens only after This Mac's login shell has answered whether herdr is there (herdr on each machine), so the page never shows and then goes.
• Nothing changes in the app while it shows: its pictures are pictures.
• Reduce Motion: pages cross-fade, nothing moves.

Living pictures

• The intro. The logo's three panes come in back to front with the name under them. Then they slide apart and resize into the window in the first page's picture, its sidebar and two panes, as the name fades out, and the picture fades in over them. A key or a click goes straight to the first page. About 2 s.
• Five pages, each a short silent clip of the app over the whole panel: sessions keep running (a dev server's log and a build beside it); panes, tabs and spaces (a split, a tab, then a space no other page shows); an agent's finished turn in its terminal and in Chat, two pictures faded into each other; Claude Code opening Git and a plugin beside it and a browser in a new tab; Add Machine with an SSH target typed in. The title, its line and the buttons sit at the panel's foot, over a shade 180 pt tall (black in dark, white in light): fully dark at the panel's edge, fading out above the title. The words carry a soft glow of the same color.
• The clips show the app's whole window, its title row and buttons, as it is: no zoom, 3:2 like the panel, in the app's appearance (dark or light, switched while the panel shows), over a plain black or white desktop. A page's clip starts from its beginning when the page shows and loops while it stays; pages turn only on Next, Back or the keys. Pages cross-fade, the new clip from a touch larger. Reduce Motion: each clip's frame where its change shows, still.
• The herdr step (last, only without herdr): herdr's own logo, as it is, on a small tile with a hairline border, Install herdr and its command, its progress, then a green check on the same tile, "herdr is installed" and the title "You're all set". The line under the title says why herdr.
• scripts/record-onboarding.sh records the clips and the welcome's films again, in one go, on a quiet Mac.