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.

featurescustom-flow-sign-in.md

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

Custom sign-in flow

An app that builds its own sign-in screen on the SDK's API sends an SMS code to an existing user and signs them in with it. No prebuilt view is involved, so the :e2e host has a small form of its own for this.

Sub-features

  • request-code shows Clerk's error for a number no user holds.
  • complete sends the SMS code, shows the code field, verifies the code, activates the session, and returns to the home, which shows the user and the session.

How to get to it (user POV)

  • Launch the app signed out and tap Custom sign-in. The screen has a phone field and Send code, then a code field and Verify code.

Driving it with verify

Preconditions:

  • The standard settings turn the phone_code strategy on. up fails with INSTANCE_MISCONFIGURED when the application does not show it.

  • The spec seeds its own +clerk_test user with host.seedUser({ phone: true }).

  • Request the code. Run e2e-tests/bin/control-clerk-android run custom-flow-sign-in/complete. Each test launches and taps e2e.home.customSignIn, which customSignInLink(screen) in specs/compose.ts finds. The spec fills verify.customSignIn.phoneNumber with the user's phone, taps verify.customSignIn.sendCode, and expects verify.customSignIn.code and verify.customSignIn.verifyCode with no verify.customSignIn.error. The form shows the code field only when Clerk.auth.signInWithOtp returned success. Screenshot custom-code.

  • Unknown number. Run e2e-tests/bin/control-clerk-android run custom-flow-sign-in/request-code. It fills a number from host.newPhone(), which no user holds, and expects verify.customSignIn.error to read Couldn't find your account., with no code field. Screenshot custom-error.

  • Enter the code. complete then types CLERK_TEST_CODE and taps verify.customSignIn.verifyCode, which calls SignIn.verifyCode and then Clerk.auth.setActive. The host leaves the form only when both returned success, so host.expectSignedInAs(user), which waits for the home to show the user's email, the seeded user ID, and a session ID, proves both. Screenshot custom-signed-in.

  • Proof. Both specs pass.

Gotchas

  • The form trims what is typed and changes nothing else, so fill the whole number, user.phone, with its +1.
  • A sign-in error shows in verify.customSignIn.error, and the form stays on screen.
  • The host shows the form until the form reports that its sign-in succeeded. A session alone does not close it, because the SDK has an active session as soon as the code is verified, before setActive is called.
  • Couldn't find your account. is Clerk's message for an identifier no user holds. It comes from the API, so a change of that wording fails request-code.
  • The screen keeps no state across launches. Every launch starts on the home, and the link opens the form on the phone field.

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