Index of every page on this site: llms.txt
All skills
clerk avatar

/verify-clerk-android

@4ee2671
by clerkclerk/clerk-android18 stars
17
Run it yourself

Drive the clerk-android SDK UI (AuthView, UserButton, UserProfileView, OrganizationSwitcher, OrganizationProfileView, session tasks) in the :e2e host app on an Android emulator, on this machine or on a CI runner, against a real Clerk development instance that the CLI creates and deletes, and capture video, screenshots, and the app log as evidence. Use it to prove any change to source/api, source/ui, or the :e2e host works before calling it done, to reproduce a UI bug, or to run the e2e tests.

  • 17 files
  • 155.5 KB
  • Updated 3 days ago
  • GitHub
Use this Skill: https://skilld.dev/gh/clerk/clerk-android/verify-clerk-android

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

featuresuser-button-and-profile.md

≈1.5k tokens on demand. Your agent reads this file only when SKILL.md points to it.

User button and profile

A signed-in user opens their profile from UserButton, sees their own account, and can sign out or delete the account.

Sub-features

  • user-button opens UserProfileView for the signed-in user from the home UserButton.
  • sections-and-back opens Manage account and Security from the profile, and returns to the profile with back from each.
  • add-account opens AuthView from the profile's Add account row.
  • sign-out ends the session from the home Sign out button.
  • sign-out-profile ends the session from the profile's Sign out row.
  • delete-account deletes the account from the profile's Security screen.

How to get to it (user POV)

  • Tap the avatar UserButton on the signed-in home screen.
  • Tap Sign out on the home screen, or the Sign out row in the profile.
  • Open the profile, tap Security, tap Delete account, type DELETE, and tap Delete account in the sheet.

Driving it with verify

Preconditions:

  • Each test seeds a +clerk_test user on the standard instance and signs in with a ticket on the home (host.launch({ signedInAs })). The launch lands when the home shows that user's email and user ID.

  • Profile. Run e2e-tests/bin/control-clerk-android run user-button-and-profile/profile. The first test taps clerk.userButton.profile and expects Edit profile. Screenshot user-button-profile. It taps clerk.userProfile.row.manageAccount and expects the user's email. Screenshot profile.

  • Sections and back. The second test seeds a user with a phone. It taps clerk.userButton.profile and expects Edit profile. Screenshot profile-before-sections. It taps clerk.userProfile.row.manageAccount and expects the user's email, PHONE NUMBER, the user's number as Clerk formats it, and CONNECTED ACCOUNTS. It presses back and expects Edit profile. It taps clerk.userProfile.row.security, expects ACTIVE DEVICES, presses back, and expects Edit profile with no ACTIVE DEVICES. Screenshots manage-account-sections and profile-after-back.

  • Add account. The third test opens the profile the same way, taps clerk.userProfile.row.addAccount, and expects clerk.auth.start.continue. Screenshot add-account.

  • Sign out. The fourth test taps e2e.auth.signOut and waits for the home to show Signed out with no user ID and no session ID, then expects e2e.auth.signIn. Screenshot signed-out.

  • Sign out from the profile. The fifth test opens the profile, taps clerk.userProfile.row.signOut, and waits for the same signed-out home. The profile closes when the user is gone. Screenshot signed-out-from-profile.

  • Delete account. Run e2e-tests/bin/control-clerk-android run user-button-and-profile/delete-account. The spec launches with authMode: 'signIn', opens the profile, taps clerk.userProfile.row.security, and taps Delete account. It expects the sheet's warning, Are you sure you want to delete your account? This action is permanent and irreversible., types DELETE into the one text box of the sheet, and taps the sheet's Delete account button. It waits for the home to show Signed out. It then taps e2e.auth.signIn, enters the deleted user's email, taps clerk.auth.start.continue, and expects Couldn't find your account.. Screenshot account-deleted.

  • Proof. specs/features/user-button-and-profile/profile.e2e.ts and delete-account.e2e.ts pass. The video shows the home naming the seeded user before each test opens the profile, and Signed out after each sign-out.

Gotchas

  • Edit profile, the section headers of Manage account, ACTIVE DEVICES, and the user's email address on the profile have no test tag, so those checks use text.
  • The Security row opens a list of active devices with the public IP address and city of the machine that runs the emulator. No spec takes a screenshot while that list is on screen, and the video of a run shows it.
  • The Security screen and the delete sheet have no test tags. Delete account is the text of the row on the Security screen, and of both the title and the button of the sheet. The screen tree leaves out what a sheet covers, so the text matches one node before the sheet opens and two after. The spec taps the row while it is the only match and the button with .last(). The confirmation field is the only textbox in the sheet. The button stays disabled until the field holds DELETE.
  • Signed out after a deletion looks the same as after a sign-out. The sign-in attempt with the deleted email is what shows that the account is gone. It needs authMode: 'signIn', because the default mode would start a sign-up for an unknown email.
  • Couldn't find your account. shows in a message at the bottom of the sign-in screen that closes itself after a few seconds. It is Clerk's wording, so a change of it fails the spec.
  • A new application has reverification on, and the Platform API has no setting for it. Clerk accepts the deletion without another verification because the ticket sign-in happened seconds earlier. A spec that deletes the account long after its sign-in can be asked to verify again.
  • clerk.userButton.profile is the clickable icon button itself, with the avatar inside it. agent-device refuses a plain tap on it with "no parent-owned touch point outside its interactive descendants", so tap it with host.tap(middleOf(locator)), and middleOf is in specs/compose.ts.
  • Edit profile is also the title of the screen it opens, so on its own it does not show that the profile's first screen is up.
  • Ticket sign-in is a shortcut, not the feature. It is fine here because this feature is not about authentication.
  • The host shows a spinner while the ticket sign-in runs. host.launch returns once the home shows the user, and fails with the reason when the sign-in fails.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at 4ee2671. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 3 days ago

README badge

README badge for clerk/clerk-android/verify-clerk-android