Home / About / Engineering / 018: Guide a first-time reader through the whole loop, from the early-access key to the first note sent

Engineering · open

018: Guide a first-time reader through the whole loop, from the early-access key to the first note sent

Guide a first-time reader through the whole loop, from the early-access key to the first note sent

Id018
Statusopen
KindStory
Priorityhigh
Created2026-10-12T15:20:00Z
Sourcethe owner's first run of v0.12.0 on an iPad, 12 October 2026: three screenshots and a note kept in the pane, relayed in chat
Releasev0.12.2
Effortmedium
Fileadmin/engineering/issues/open/018-first-time-guidance.md

What is asked

The owner: "we need to guide the user so that anybody who never used this before can follow up … we need to create a better experience." The three steps (007) are the start; this card is the whole first run: what to do, in order, on the page where it happens, with what each step makes and why.

Scenario

Given I arrive with nothing
When I open the pane
Then it tells me the loop in three lines and what the first step is
And every step says what it makes (a passkey, three vaults, a file, a lane) and what leaves the browser
And at the end I can see what I made, in the Keys tab, and what I sent

Mock-up

A first-run card at the top of This page, dismissible, that follows the steps; the vault page's "The feedback loop" section as the long form.

Back to the board.

For an agent

Issue 018 on newsroom.sgit.ai: Guide a first-time reader through the whole loop, from the early-access key to the first note sent. Status open, kind story, priority high, release v0.12.2. Source file admin/engineering/issues/open/018-first-time-guidance.md.