✅ As a new user opening the desktop app for the first time, I want to create my remote Hypermedia identity
Behavior from source: First-launch welcome offers join, create-site and account entry points. Choosing remote identity creation hands email verification and passkey setup to the browser, then returns to the app for a required name, optional photo and notification preference. Remote storage is the default; storage and device management are deferred to Account Settings. The basic flow includes cancellation before browser handoff and retry/validation edge cases.
Original source · exact version bafyreihtutou6xvzppgxgr4fh23355e4opdmfkrexpqps5kly4eepjpzaq
Reviewed migration decision · Journey map · local task ID ut-887ae59c4a23e692.
Confidence: high; review status: needs-review. Similar source records are not merged. Source status icon is not a committed release or current product state.
Source acceptance and behavior
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
Develop Seed Hypermedia is pre-loaded in Joined Sites as a default
"Get started with Seed" item is pinned to the bottom of the sidebar and persists until user do one of the actions.
The account creation entry screen offers three options: Create identity in Hypermedia, Already have a Hypermedia identity, I have an identity from another site?
Tapping "Create identity in Hypermedia" opens the browser automatically at the Hypermedia setup URL — an intermediate screen to do this switch
The browser flow handles email and passkey setup — behaviour as defined in US-01
Profile screen requires a name and allows an optional photo. An email notification preference checkbox is shown on the profile screen, pre-ticked.
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]"
"Get started with Seed" sidebar item disappears once all steps are complete
Avatar in the top right updates to reflect the user's photo or initial
The identity is saved remotely by default — no decision is asked during onboarding
The user can change their identity storage preference at any time in Account Settings
Account Settings shows the user's connected devices, email, and current sync/storage status (remote)
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.
A step communicating the user the browser will be open to finish set up appears. If user cancels will go back to main screen.
⚠️ Browser fails to open → error shown in app with retry option
⚠️ User closes the browser mid-flow → returns to app, identity not yet created, "Get started" remains as a reminder
⚠️ User pastes an invalid URL in the join site field → inline error: "That doesn't look like a valid site link"
⚠️ User submits profile without a name → validation error shown, photo remains optional
⚠️ Unsupported image or oversized file uploaded → clear error with accepted formats and size limit
Full original readable source 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
