docs(expo): add the CLI output reference and the screen advice from clerk-ios

[mikepitre]

Description

This PR sits on #10227 and must merge after it. clerk/clerk-android#1093 is the same change for clerk-android.

The clerk-ios verification skill has text that the Expo skill lacked. This PR adds it, written for the Expo package, and checked against the code in integration/expo-native/. It changes three files of .claude/skills/verify-clerk-expo/ and adds one.

What came over from clerk-ios:

• A new references/output.md has what each verb prints, the exit code table, and the error code table. SKILL.md had one sentence on exit codes, and now points at the file.
• SKILL.md says what screen shows right after up, and how a missing node fails.
• features/README.md has the Baseline preconditions section.

What is different here, and why:

• POOL_FULL covers four iOS lanes and two Android lanes. DEVICE_BUSY also covers a run on the other platform that holds the worktree's application. BUILD_FAILED names the step of the test app's build that failed, such as expo prebuild or xcodebuild, with its last 15 lines.
• Exit code 0 also covers a run in which every selected spec is limited to the other platform, as SKILL.md already says.
• A down --platform that keeps the application for the other lane lists no application in its JSON.
• clerk-ios says screen right after up shows the host's error screen. Here screen opens the test app without the verify inputs, and a local dev client and a Release build show different things then. The text says only that the screen is not one a spec sees, which holds for both.

Two facts differ from the clerk-ios text on every platform. NOT_TEST_IDENTITY is in the list of error codes, but no command raises it, and the table says so. doctor --json prints its report with ok: false and no error when a check fails.

references/remote.md had two sentences from clerk-ios that the code does not support. Only the two egress checks of doctor print blocked:, and a 403 on push means that this machine's credential may not push. The file now says that, and clerk/clerk-ios#696 makes the same fix there.

Not brought over: the clerk-ios line that the screen tree leaves out what a sheet covers. Whether that holds for the modal AuthView of the test app needs a device to see. The cloud environment text and the driving conventions were already here.

The changeset is empty, as in the other PRs of the stack. npm test in integration/expo-native/ passes 797 of 797. An earlier run timed out once in test/session-agent.test.ts while it waited for a tunnel file, and passed when run again. This PR changes no code, so that test is not about this change.

Checklist

• pnpm test runs as expected.
• pnpm build runs as expected.
• (If applicable) JSDoc comments have been added or updated for any package exports
• (If applicable) Documentation has been updated

Type of change

• 🐛 Bug fix
• 🌟 New feature
• 🔨 Breaking change
• 📖 Refactoring / dependency upgrade / documentation
• other:

🤖 Generated with Claude Code

[changeset-bot]

🦋 Changeset detected

Latest commit: 442a0fa

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
clerk-js-sandbox	Ready	Preview	Oct 14, 2026 12:41pm UTC
swingset	Ready	Preview	Oct 14, 2026 12:41pm UTC

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

_{Comment @coderabbitai help to get the list of available commands.}

[pkg-pr-new]

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@10228

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@10228

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@10228

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@10228

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@10228

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@10228

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@10228

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@10228

@clerk/expo-biometrics

npm i https://pkg.pr.new/@clerk/expo-biometrics@10228

@clerk/expo-google-signin

npm i https://pkg.pr.new/@clerk/expo-google-signin@10228

@clerk/expo-native-components

npm i https://pkg.pr.new/@clerk/expo-native-components@10228

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@10228

@clerk/express

npm i https://pkg.pr.new/@clerk/express@10228

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@10228

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@10228

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@10228

@clerk/mosaic

npm i https://pkg.pr.new/@clerk/mosaic@10228

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@10228

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@10228

@clerk/react

npm i https://pkg.pr.new/@clerk/react@10228

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@10228

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@10228

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@10228

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@10228

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@10228

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@10228

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@10228

commit: 442a0fa

[mikepitre]

Replaced by the regrouped stack #10235, #10236, #10237 and #10238, which ends on the same code (tree c2fc7c19). The old stack grew one PR per port from clerk-ios and clerk-android; the new one groups what a reviewer reads together.