Hosted onhyper.mediavia theHypermedia Protocol

Document cover
UT-03 — Sign in and new identity clicking the avatar

US-3.1 —As a returning user, I want to sign in to my existing Hypermedia identity from the browser avatar icon so and join the site.

Acceptance Criteria

  • Avatar icon is outlined when the user is not signed in

  • Tapping the avatar opens a modal with three options: "Create my identity" and "Sign in — I already have an identity" or I have an identity from another site

  • Tapping "Sign in — I already have an identity" leads to the passkey screen

  • Passkey screen shows "Good to see you again", the email, and a "Sign in with passkey" button

  • "Use another email" option is available on the passkey screen

  • After passkey confirmation, if the user has more than one account, a "Connect your account" screen appears

  • The "Connect your account" screen lists all available accounts with one pre-selected.

  • User can change the selected account and tap "Confirm account" to proceed

  • If the user has only one account, this screen is skipped

  • Avatar updates to show the user's profile photo after sign-in

  • If already a member, Join button disappears and a toast confirms access

  • If not yet a member, Join button remains until tapped

Basic Flow

  • Tap avatar → account option appears

  • Sign in → Screen confirmation appears with "Good to see you again"

  • Confirm passkey → signed in, account options appears if user has more than one

  • Already a member → Join button disappears, toast appears

  • Not a member → Join button stays, user taps it to enrol

Edge Cases

  • User taps "Use another email" → email input appears → enters new email → returns to passkey screen

  • User enters an email not linked to any identity → Create new account flow prompt

  • User cancels or fails passkey → error shown, option to retry

  • Account list is empty → only "Create my identity" option is shown

  • User is already signed in → avatar shows photo, no sign-in flow triggered but list options (account settings, profile....)

  • Network error during sign-in → error message shown with option to retry

US-3.2 — As a returning user, I want to sign in to my existing Hypermedia identity from the desktop app avatar icon so that I can access my account across any site.

Acceptance criteria and so is the same except in app we have app settings.

🗑️ When user is logged in remove "Vault stored locally" copy from the drop down, when user is logged in please.

Remove "Vault store locally" textRemove "Vault store locally" text

US-3.3.—As a returning user I want to create a new account in the browser by tapping the avatar

Do you like what you are reading? Subscribe to receive updates.

Unsubscribe anytime