verify-clerk-expo
verify-clerk-expo
integration/expo-native/bin/control-clerk-expo is a control CLI over e2e 0.18.0 and @e2e-dev/mobile 0.10.0. It builds the expo-native test app in integration/templates/expo-native, leases a simulator or emulator, creates one Clerk application for the worktree, seeds +clerk_test users, runs specs, and keeps the evidence. On a Mac the device is local, the test app is a Debug dev client, and Metro serves your working tree to it. On a machine that cannot run the device, the CLI leases one on a GitHub Actions runner, and the runner builds your pushed commit as a Release app with the JS embedded. The verbs, specs, and evidence are the same.
The tests are an ordinary e2e project. e2e.config.ts and specs/ run under npx e2e run when the environment names a device, a build of the test app, and a development instance's keys. The CLI sits on top: it makes those three for a run and keeps the evidence. The package README has the commands for a run by hand and what such a run leaves out.
No change to @clerk/expo or @clerk/expo-native-components UI or auth behavior is done until a simulator or emulator shows the changed behavior, on each platform the change touches. A run on the test app is one way to show it. An app of your own that exercises the change is just as good.
Run every command from the repo root. In the prose below, doctor, up, run, screen, attach, and down are verbs of that CLI. The tests and the CLI are the Node package integration/expo-native/, and paths that begin specs/, src/, test/, or .verify/ are inside it. features/ and references/ are beside this file. Every verb but attach takes --platform ios|android, and iOS is the default. Every error prints a fix line. Every verb takes --json, and CLI output has its shape, the exit codes, and the error codes.
The test app links @clerk/expo, @clerk/expo-native-components, @clerk/expo-biometrics, and @clerk/expo-google-signin from the workspace. It does not install @clerk/expo-passkeys, so the skill cannot verify passkeys.
Launch
Set up each machine once.