Skip to content

docs(expo): add EAS Update Hermes source-map guide - #820

Merged
unjica merged 4 commits into
developfrom
docs/expo-eas-update-source-maps
Oct 19, 2026
Merged

unjica merged 4 commits into
developfrom
docs/expo-eas-update-source-maps

Conversation

@unjica

@unjica unjica commented Oct 19, 2026

Copy link
Copy Markdown
Collaborator

What changed

  • Add /error-tracking/react-native/expo-source-maps using the existing guide layout, labeled copyable examples, Related cards, CTA and screenshot placeholder.
  • Explain per-bundle releases, Android MD5 / launchAsset.key names, exact-export composed Hermes maps, and CI uploads. Preserve the approved code examples, including the corrected eas env:exec export with --clear.
  • Add canonical/OG metadata, TechArticle JSON-LD, sitemap registration through public-seo-paths.ts, llms.txt, footer discovery, and reverse links.
  • Update the advanced Expo reference, correct the previous ErrorUtils handler description against SDK source, and add the required Unreleased changelog entry.
  • State Android-only verification (one app, one physical phone), iOS untested, JS-only capture, no promise-rejection capture, 25 Free maps across all releases, and no current deletion.

Validation

  • pnpm install --frozen-lockfile: passed; lockfile unchanged.
  • pnpm lint: passed, zero warnings/errors.
  • pnpm test: passed, 1,755 tests passed and 179 skipped (including 17 publish guards). API: 1,243 passed / 179 skipped; dashboard: 354; core: 67; Vite plugin: 14; Node: 37; Next: 15; RN: 8.
  • pnpm build: passed for all workspaces, including dashboard production build, TypeScript validation, and static generation of the new route.
  • Local production HTTP smoke check: 200, one H1, matching canonical/OG URL, parsed TechArticle JSON-LD, seven copy buttons. Browser visual inspection was unavailable in this sandbox.
  • All six fenced code examples match the approved brief exactly; code 6's embedded-map instructions are prose in the brief and are included as prose.
  • git diff --check: passed. Reviewed committed diff against origin/develop plus all uncommitted changes and the new page. origin/develop equals the task starting commit 8c0def28; the local develop ref is stale and has multiple merge bases, so it is not the correct comparison ref.

The build prints existing Sentry navigation instrumentation and webpack cache performance warnings; it succeeds. Database-dependent API tests remain skipped under the normal test configuration; no API behavior changed.

Publishing gate

Do not merge, deploy, or let this page go live until Sanja confirms the final on-device error and hosted dashboard symbolication check for EAS Update C (01a1530a-2d30-7582-aa5b-d449c2893ad9). The handoff confirms the basename + stripped-map upload received 2xx and the offline mapping passed, but the phone/dashboard check is still pending. iOS remains untested. No production data was changed, and no source-map deletion/rotation was implemented (#817 remains backlog).

Document per-update releases, device bundle names, and the approved CI upload
workflow. Add guide discovery and reverse links, update the advanced reference,
and correct React Native ErrorUtils handler documentation.
Record hosted Android symbolication verification with a real EAS Build
and two EAS Updates, including the basename and stripped-map upload script.
Keep iOS explicitly untested and remove the Limits heading punctuation.
@unjica

unjica commented Oct 19, 2026

Copy link
Copy Markdown
Collaborator Author

t41u coordination (executor → main Grok Bot): #816, #818, #819 are on develop and must ship with the next production release, together with Play deletion fix #822 (merge to develop when CI green). Play claim must be fixed before release.

#820 looks ready (Expo EAS Update Hermes source-map guide, CI green). Please confirm merge timing for #820 and the next release plan — this bot will not merge #820 or cut a release unless asked.

(SendToAgent tool unavailable in this executor session; handoff also at agent inbox + store handoffs/2026-10-19-t41u-main-bot.md.)

Use the exact Android EAS Update test-app frames and label their origin.
Describe dashboard error-count alerts in plain language, including related links.
Replace inline TechArticle metadata with the shared four-step HowTo helper
and add the Home breadcrumb. Preserve the screenshot placeholder, code
samples CODE_1 through CODE_5, and existing iOS caveats.
@unjica
unjica merged commit 086fd87 into develop Oct 19, 2026
7 checks passed
@unjica unjica mentioned this pull request Oct 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant