README.md

Specs

Table of contents for all specs. Start here.

How Specs Are Organized

• specs/projects/ — active project specs you implement against
• specs/topics/ — standalone docs (not full projects)
• specs/framework/ — templates for writing new specs
• specs/archive/ — retired specs

Projects

• SDK — active WebView-first scope, paused native tracks, execution status

Topics

• React Native Upgrade Plan (Mobile App) — staged migration plan from RN 0.77 to supported versions.
• RN Upgrade Checklist — shared owner/status tracker for coordinating the upgrade across developers.
• RN Upgrade Follow-Ups — deferred hygiene and ownership items surfaced during the RN 0.83 / Expo SDK 55 upgrade.

Framework

• Templates — copy-paste templates for all three tiers
• Spec Execution Model — stable context plus one plan file per PR
• Product Spec Enhancement Prompt — Figma cross-reference agent prompt
• HTML Spec Practices — fonts, palette, layout, interactive open questions, CSS strategy

Project rules and invariants live in the root CLAUDE.md / AGENTS.md; the planning protocol and spec-writing guidelines live in SDK Contributing.

Other

• Spec Archive — append-only log of retired specs

Reading Order

1. This file (specs/README.md)
2. specs/projects/sdk/INDEX.md — find your active workstream or paused native track
3. The workstream SPEC.md — find the backlog row and active plan
4. The linked plans/<BACKLOG-ID>-<slug>.md file — execute from this file
5. specs/projects/sdk/OVERVIEW.md — if you need architecture context