[Programcode]

Round 4 of iOS parity (~/.t3/scratch/ios-parity/PARITY.md, "Round 4" and section 2), plus the grouped iPad sidebar Adam asked for. Everything runs in Expo Go except the parts listed under "Needs a development build", which are written and gated so Expo Go is unaffected.

What changed

Case format v2 (#244). origin/main is merged in with a normal merge. Main's #244 changed website files that round 1 had moved into packages/core, so the merge keeps the website's re-exports and ports main's changes into core: the live draft sections, the transform, the regenerate merge, the R2/Conclusor argument check (now hasExpectedArguments, shared) and the flowchart built from readCase. The app renders cases with readCase as the website's GenerateResults does: opening (hook, definition, "What we will show"), arguments with explanation, evidence and why it matters, R2's backed-up arguments, Conclusor's "Why we win", "If they say… / We answer", closing line and sources. Older cases show their sections under the website's plain names. PDF, copied text, Discuss and the Regenerate list follow it.

iPad sidebar (Adam's addition). A full-screen iPad window shows the app's own sidebar beside the root stack, so it stays while a tool is open:

• The Current Debate switcher and New debate sit on top.
• Below them come collapsible sections: Debate (Dashboard, History), Prepare (Generate, Attack, Brainstorm, Factoids, Ask), Practice (Sparring, Crossfire, Flowchart, Timer), Library (Sources, Paste a link, Write a note, Import a file) and You.
• Closed sections are remembered on the device. The current screen is highlighted, including a tool's saved documents, and a closed section holding it shows a dot.
• VoiceOver reads the section headers as headings with their expanded state. Rows grow with Dynamic Type, and the sidebar widens with the text size up to a cap.
• The native tab bar hides there. Split View, Slide Over, Stage Manager windows and widths under 700 keep the tab bar.
• Screens lay out for the room beside the sidebar through ReservedWidth.
• Round 3's small Practice tools aren't on this branch yet. They go at the end of Practice in sidebar-items.ts.

Share links. Saved cases, attacks, brainstorms and factoids have Share link in their menu:

• It calls the existing share Edge Function and opens the share sheet. A link made this session for the same unchanged result is reused, because every call makes a new link and counts toward the 50-a-day limit.
• share/[code] is a read-only viewer that works signed in or out, through the public get_shared_item RPC.
• Staging links point to production: with no browser Origin the function falls back to PUBLIC_WEB_APP_ORIGIN, which defaults to https://debateowl.com (supabase/functions/_shared/cors.ts). That holds unless staging sets PUBLIC_WEB_APP_ORIGIN, a config change not made here.

Universal links, app side. +native-intent.tsx maps https://debateowl.com/share/<code> and /app/<page> (and www) to app routes; any other web address opens the Debate tab. The parser is tested against other hosts, ports, user info, encoded segments and javascript: URLs. Development builds get the Associated Domains entitlement. The website's apple-app-site-association file is a follow-up for Adam (below).

Accessibility.

• Every text field has a Done bar above the keyboard.
• Tabs, tool forms, documents, the Library panes and the Flowchart scroll fields clear of the keyboard.
• VoiceOver hears a finished Ask answer, Crossfire reply, Sparring speech or tool result once, never token by token.
• More section titles are headings, and swipe rows already had their custom actions.
• Text grows with Dynamic Type everywhere. Only fixed chrome is capped: floating action-bar buttons and segmented controls at 1.6, the sidebar at 1.35.
• iPad shortcuts: ⌘N new debate, ⌘K switcher, ⌘↩ send in Ask, Crossfire and Sparring. They work in the web preview; on iOS they need a UIKeyCommand module in the development build. Space for the timer belongs to round 3's timer work.

Home Screen widget, quick actions, Spotlight (development build).

• The Current Debate widget comes in small and medium: the motion, sources, results and rounds, plus a Spar link. The debate context and the Debate tab publish to it.
• Quick actions (New debate, Start timer, Ask your coach) and Spotlight (the Current Debate's cases) are written behind nativeCapabilities(). They switch on only once expo-quick-actions or expo-core-spotlight is installed. I didn't install either: neither has been tried on SDK 57 on a device.

Offline queue.

• New notes, source edits and Active switches go through one queue kept on the phone under the user id. Without a connection the change shows at once with "Waiting to sync".
• It replays in order on launch, reconnect, foreground and every 30 seconds while anything waits, then says "N changes synced".
• Changes are merged per source. A change the server refuses is dropped and reported once. Another account never replays this account's queue.

First run and notices.

• Ollie's welcome animates line by line as on the website, followed by the website's four-step tour as native pages. The welcome shows once per phone and the tour once per account, under the website's keys.
• The Debate tab shows the trial banner ("Free trial: 2 days left."); the day count moved to packages/core/src/trial.ts.
• The sign-in screen says "Your session expired. Sign in again." when the server ended the session (refused refresh, on launch or later), never after a sign-out the student asked for.

Word export. The website's DOCX builders moved unchanged to packages/core/src/export/docx.ts. Every part of the generated files (534 files across English and Hungarian, every tool) is identical before and after. The app packs them with Packer.toBase64String and shares the .docx. docx compiles with hermesc and runs with no Node or DOM globals; it hasn't run on a device.

Motion, the Duolingo pass (animations only; no new features, every label kept).

• Ollie moves as the website's owl does (src/index.css, "The owl's motion"), ported to Reanimated on the UI thread:
  • lids blink over each pose's eyes on the owl's own clock;
  • a slow breath from the feet;
  • the pose's wave, cheer or hop when it arrives or changes pose, and a pop on the website's spring.
  • The logo mark and the avatars that stand for work in progress blink; the loader bobs. The web has no Lottie or Rive files, so this ports its CSS keyframes.
• The 3D buttons spring down onto their darker ledge and bounce back, with a light tap on main actions.
• The mint check pops on the overshoot curve while its tick draws in (toasts, sign-in, saved notices).
• Lists and documents load as skeletons with the website's shimmer instead of spinners; rows fade up 40 ms apart and slide into the gap a deleted row leaves; cards, tiles and rows press in.
• The iPad sidebar's chevron springs and its rows slide; live draft sections pop in.
• Finishing a Sparring round, a Crossfire round or a freshly generated case opens a celebration: Ollie cheers, confetti, the mint check, and the existing stats count up. It shows once per finish and is one dismissable button for VoiceOver.
• Sparring's score bars fill with a spring; scorecard and debrief cards pop in staggered.
• Reduce Motion follows the system setting live, and everything is still under it. The screenshot script runs with reduced motion so shots show screens at rest; MOTION=1 plays motion and RECORD_DIR records video.
• No streak feather: no streak exists on the website or in the app, and adding one would be a new feature.
• Native stack pushes keep iOS's own timing; the motion lives in buttons, lists, cards and the owl.

Screenshot script.

• New groups: sidebar, first-run and share. The share group makes one real link on staging and opens it in the viewer.
• FONT_SCALE draws a Dynamic Type size in the web preview.
• FUNCTIONS_ORIGIN lets the script use any port while relaying Edge Function calls with an allowed Origin, so parallel worktrees don't collide on 18080.

Verification

• npm run verify passes locally on 346d6a29: docs check, lint (eslint and knip), typecheck (website, agentic, core, mobile), vitest 870 tests, collaboration 30, Edge Function tests 553, build, service-worker test, and Playwright smoke 47 passed. GitHub Actions is billing-blocked, so this is a local pass, not CI.
• Twelve Codex review rounds (gpt-6.1-sol, xhigh) on pinned snapshots, rounds 1 to 11 on earlier heads. Every finding was fixed with a test where the logic allowed, and each new test fails without its fix:
  • round 1: 4 findings;
  • rounds 2 and 3: 2 each;
  • rounds 4 to 7: 3, 4, 3 and 3;
  • rounds 8 and 9: 2 each;
  • rounds 10 and 11: 5 and 3.
    Round 12 (on 4638ab5d) hung and was cancelled.
• After round 12, two suspected queue issues were checked by hand in 346d6a29:
  • A save whose account changed before it ran was reported as a success. It told its caller the change was kept and cleared the storage-failure flag. Fixed, with a test that fails without the fix.
  • The suspected duplicate send after a failed retirement save is not a bug: the sent change has already left the queue by then, and replay runs one at a time. A concurrency test pins this.
• npx expo config --json without DEBATELAB_BUILD is byte-identical to before, so the Expo Go config is unchanged. The development build gains Associated Domains, and with DEBATELAB_APP_GROUP the CurrentDebate widget.
• Real staging: the share group makes a real share link and opens it in the in-app viewer.
• The web export, driven with Playwright through the screenshot script, covers:
  • the sidebar checks, including Split View at 600 points and a cold link followed by Back;
  • the expired-session notice, with a refused refresh;
  • the trial banner and the first run;
  • celebrations on Sparring, Crossfire and a new case;
  • the v2 case document.
• Not verified (needs a development build or a device):
  • native VoiceOver announcements;
  • the iOS Done bar;
  • Dynamic Type on device;
  • the share sheet;
  • universal links;
  • the widget, quick actions and Spotlight;
  • the hardware-keyboard shortcuts on iOS;
  • 60 fps on device;
  • the Word file opening in Pages or Word;
  • opening a queued local: note.

Screenshots

In ~/.t3/scratch/ios-parity/r4-shots/ (on the VPS):

• 663 shots: iPhone light and dark (English), iPhone light (Hungarian), iPad portrait light and dark (English), iPad light (Hungarian), 11-inch iPad landscape dark, and a 600-point Split View window.
• ax/: 115 shots at the largest accessibility text size (FONT_SCALE 3.1), iPhone and iPad.
• motion/: 26 screen recordings (WebM) of the animations with motion on, including ipad-sidebar-sections.webm.

New states worth opening first:

• ipad-light-en-sidebar-expanded.png and ipad-air-landscape-dark-en-sidebar-collapsed.png: the grouped iPad sidebar.
• iphone-light-en-case.png: a case in the v2 format.
• iphone-light-en-case-celebration.png, iphone-light-en-sparring-celebration.png and iphone-light-en-crossfire-celebration.png: the celebrations.
• iphone-light-en-welcome.png, iphone-light-en-tour-debate.png and iphone-light-en-tour-ready.png: Ollie's welcome and the tour.
• iphone-light-en-trial-banner.png and iphone-light-en-session-expired.png: the two notices.
• iphone-light-en-shared-case.png: a share link opened in the app.
• iphone-light-hu-case.png: a case in Hungarian.
• ax/iphone-light-en-debate.png and ax/iphone-light-en-library.png: the largest text size.

Needs Adam

• Apple Developer account. Provisioning for a development build with:
  • Associated Domains (applinks:debateowl.com, applinks:www.debateowl.com);
  • an App Group (DEBATELAB_APP_GROUP) for the widget, which round 3's Live Activity also needs;
  • later, Push.
• Bundle id decision. It's still com.adam.debatelab, and the AASA appIDs below depend on it.
• The website's AASA file and its deploy. Serve https://debateowl.com/.well-known/apple-app-site-association (and on www) as application/json, with no redirect, and make sure vercel.json's SPA fallback doesn't catch it. Replace TEAMID with the team ID:

  {
    "applinks": {
      "details": [
        {
          "appIDs": ["TEAMID.com.adam.debatelab"],
          "components": [
            { "/": "/share/*", "comment": "Shared results" },
            { "/": "/app/*", "comment": "App pages" }
          ]
        }
      ]
    }
  }

• Optional staging config. Set PUBLIC_WEB_APP_ORIGIN on staging so staging share links open the staging site.
• Packages to decide on for the development build.
  • expo-quick-actions (its compatibility table stops at SDK 54).
  • expo-core-spotlight@^2, which supports SDK 56–57 but whose plugin patches AppDelegate.swift.
  • A UIKeyCommand module for the hardware-keyboard shortcuts.
• EAS build within the budget in apps/mobile/AGENTS.md.
• Device test of everything marked "needs dev build" below, plus:
  • VoiceOver announcements;
  • the Done bar;
  • Dynamic Type at AX5;
  • the share sheet;
  • opening a queued local: note;
  • the Word file in Pages or Word.

🤖 Generated with Claude Code

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

Run configuration

• Source mode: Auto
• Repository: Programcode/DebateLab
• Branch: native-ios/parity-r4-polish
• File: .coderabbit.yaml
• Commit: 346d6a2
• Layers: Repository YAML (base), Organization UI (inherited)
• Review profile: CHILL
• Plan: Free
• Run ID: 3e7c9208-6f72-4c8e-b0f6-3b40f9d67203

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

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

Note

🎁 Summarized by CodeRabbit Free

Your organization is on the Free plan. CodeRabbit will generate a high-level summary and a walkthrough for each pull request. For a comprehensive line-by-line review, please upgrade your subscription to CodeRabbit Essentials by visiting https://app.coderabbit.ai/settings/billing.

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

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota.

[Programcode]

Replaced by #266, which combined rounds 3 and 4 and is now merged.