Source decision 0032 — ✅ As a new user opening the desktop app for the first time, I want to create my remote Hypermedia identity
Original source · exact version bafyreihtutou6xvzppgxgr4fh23355e4opdmfkrexpqps5kly4eepjpzaq · Read-derived block
Classification: story; source kind: story; decision: approve; confidence: high; review status: needs-review.
Rationale: Full nested acceptance criteria, ordered flow and edge cases support a behavior story, not a title-only inference. Review is required for the reminder dismissal condition (one action versus all steps), completion/profile copy ordering, and explicitly deferred create-site outcome; the checkmark is not delivery proof.
Review qualification: Uncertain identity/behavior/duplication remains a separate candidate; do not merge without review.
Canonical target (to be published after manifest): Proposed canonical target
Similar source candidates — kept separate
Evidence snapshot: original readable text and block backlinks
Heading Design source block
Paragraph Video prototype source block
Paragraph Screens by steps source block
Paragraph Final screen when user comes from (1)Join (2) Comment (3) Create account (4) Create site TBD source block
Paragraph Acceptance Criteria source block
Paragraph On first launch the app shows a welcome screen explaining what Seed is with three actions: Join a site, Create a site, and Sign in or create an account source block
Paragraph Create a site flow will be added on next implementation when we have ready the new design source block
Paragraph Develop Seed Hypermedia is pre-loaded in Joined Sites as a default source block
Paragraph "Get started with Seed" item is pinned to the bottom of the sidebar and persists until user do one of the actions. source block
Paragraph The account creation entry screen offers three options: Create identity in Hypermedia, Already have a Hypermedia identity, I have an identity from another site? source block
Paragraph Tapping "Create identity in Hypermedia" opens the browser automatically at the Hypermedia setup URL — an intermediate screen to do this switch source block
Paragraph The browser flow handles email and passkey setup — behaviour as defined in US-01 source block
Paragraph Profile screen requires a name and allows an optional photo. An email notification preference checkbox is shown on the profile screen, pre-ticked. source block
Paragraph On browser completion, it returns to the app and continues to profile with an intermediate screen to do this switch -> "You're all set, [name]" source block
Paragraph "Get started with Seed" sidebar item disappears once all steps are complete source block
Paragraph Avatar in the top right updates to reflect the user's photo or initial source block
Paragraph The identity is saved remotely by default — no decision is asked during onboarding source block
Paragraph The user can change their identity storage preference at any time in Account Settings source block
Paragraph Account Settings shows the user's connected devices, email, and current sync/storage status (remote) source block
Paragraph No technical terms appear in the onboarding flow — "vault", "cryptographic", "local storage" are reserved for Account Settings where the user has chosen to manage advanced options. source block
Heading Basic Flow source block
Paragraph User opens the app for the first time — welcome screen with action cards source block
Paragraph Taps "Sign in to Hypermedia or create an account" source block
Paragraph Taps "Create identity in Hypermedia" source block
Paragraph A step communicating the user the browser will be open to finish set up appears. If user cancels will go back to main screen. source block
Paragraph Browser opens automatically → email → verify → passkey → browser closes source block
Paragraph App returns to focus — profile screen source block
Paragraph User adds name, optional photo, confirms notifications source block
Paragraph "You're in, [name]" — onboarding complete source block
Paragraph Action cards available — join a site or create a site source block
Heading Edge Cases source block
Paragraph ⚠️ Browser fails to open → error shown in app with retry option source block
Paragraph ⚠️ User closes the browser mid-flow → returns to app, identity not yet created, "Get started" remains as a reminder source block
Paragraph ⚠️ User pastes an invalid URL in the join site field → inline error: "That doesn't look like a valid site link" source block
Paragraph ⚠️ User submits profile without a name → validation error shown, photo remains optional source block
Paragraph ⚠️ Unsupported image or oversized file uploaded → clear error with accepted formats and size limit source block
Do you like what you are reading? Subscribe to receive updates.
Unsubscribe anytime