[Programcode]

Round 7 of the iOS app. It fills the parity gaps left after rounds 1–6, makes the app faster and livelier, adds a release build, and produces an unsigned production IPA that Adam can re-sign with a free Apple ID and install.

Draft into feat/native-ios. Don't merge yet.

The IPA

DebateOwl-sideload.ipa (18 MB) is on the prerelease ios-r7-sideload-1. The release notes have the Sideloadly and AltStore steps and the list of what a free Apple ID can't sign.

• Built by EAS build 2f4e3d5a from 58825f3. EAS keeps its own copy until 2026-11-12.
• Release configuration, production backend, iOS 16.4+, bundle com.pistack.debateowl 1.0.0 (1).
• Contains the app, ExpoWidgetsTarget.appex and DebateOwlShare.appex, each signed ad hoc with only the App Group entitlement.
• SHA-256 68f4c87d274012834414c05325a2f87ed786fa48a3fa1d5937a1697851b98dc3.

What changed

Release build and sideloading.

• DEBATELAB_BUILD=release in app.config.ts is the development build without the development client, so it runs its built-in JavaScript.
• Without DEBATELAB_APPLE_ACCOUNT its only entitlement is the App Group. Push, Sign in with Apple and Associated Domains are dropped, because a free Apple ID can't sign them. The Expo Go config is byte-identical; I compared expo config --json before and after.
• eas.json gains two profiles:
  • release-simulator;
  • sideload, a custom EAS build (apps/mobile/.eas/build/sideload-ios.yml). It runs prebuild and the native patches, pod install, and an unsigned xcodebuild archive. Each bundle is then signed ad hoc with its prebuild entitlements, and the result is packed as DebateOwl-sideload.ipa. A normal EAS device build refuses to run without credentials, which is why this one is custom.
• push.ts reads extra.remotePush. A build without the push entitlement shows the switch as "This version of the app cannot receive notifications yet" instead of failing when iOS refuses a token.
• scripts/patch-app-group-lookup.mjs makes expo-widgets and expo-share-intent read AltStore's ALTAppGroups first. AltStore renames the App Group to <group>.<TEAMID>; with the patch, Live Activities, widgets and the share extension still work in an AltStore install. Other builds are unchanged.

Parity. The full checklist is below. New this round:

• Sparring Word export;
• deleting a saved Crossfire round;
• Generate's "Any role", plus the debate's role filled in with its motion;
• a Sparring model picker;
• the usage reset time;
• the sign-in method line in You;
• a "manage on debateowl.com" link for Stripe plans;
• custom timer formats shared as the website's ?custom= link, and opened from one;
• a language menu on the sign-in screen;
• the printable flow sheet as a PDF.

Performance.

• Saved copies first. Tabs paint their saved copy at once and refresh in the background (cachedRead's onCopy). A server refusal still surfaces, and another account's copy never shows.
• Fewer re-renders:
  • Streamed tool drafts live in a LiveValue, so only the draft re-renders, not the whole screen, 20 times a second.
  • Sparring's clock ticks in its own component.
  • React Compiler skips went from 34 files to 2: Sparring's judge request and the one-shot celebration.
• Startup:
  • The splash hides on layout.
  • Settings load in parallel with the session.
  • The unused language catalogs load only when needed.
  • date-fns imports by path.
• Long lists: the debate switcher, saved maps and long sources render virtualized.

Animation. Brand-consistent, with no sounds, lessons, leagues or XP.

• Spring presses on chips, rows and segmented controls.
• Celebrations for Attack, Brainstorm and Factoids results and at the end of a timer round.
• Ollie keeps time beside the timer's ring, which now sweeps smoothly.
• Ollie reacts to errors and to each step of a run.
• Ollie waves once for a new debate.
• Cards enter staggered on first view.
• Everything respects Reduce Motion.

Fixed after merging the three strands (found by the screenshot run and the Codex reviews):

• The sign-in language menu bypassed the lazy catalog loader, so it stayed in English.
• A stale debates refresh could hide a debate the student had just switched to.
• The five-day "Still preparing?" check could open from a stale saved copy. It now waits for the server's list.
• A row's entrance animation covered the Library's web menu.
• An offline copy, or a copy from an earlier refresh, could still count as the server's list (review round 2).

Parity checklist (website → iOS app)

Legend: ✅ in the app and wired to the same tables and functions as the website · 🆕 added in this round · ➖ not applicable on iOS (reason given).

Sign-in

• ✅ Email code, demo code, session-expired notice (sign-in.tsx, auth.tsx)
• ✅ Google (social-sign-in.ts; native builds only, needs debatelab://auth/callback in the project's redirect list)
• ✅ Sign in with Apple (an iOS extra; builds signed by DebateOwl's own Apple account)
• 🆕 Language menu on the sign-in screen (the website's LanguageSwitcher)

Debate and Current Debate

• ✅ Switcher, new, edit settings (+ judge), delete, one-off mode, five-day check, motion gate, context Review and pins, unsorted work, announcements, trial banner, limit and model-restricted sheets

Prepare

• 🆕 Generate: "Any role" and the debate's role filled in with its motion
• ✅ Generate: motion, side, length, audience, tone, style note, model, dictation, live draft, stream recovery, regenerate a part, undo, open in Crossfire, build a map, discuss, PDF, Word, share link
• ✅ Attack, Brainstorm, Factoids (every website option, bookmarks to the Factoids folder, PDF, Word, share link)

Practice

• ✅ Ask: General/Clarify, Citations, Web search, Pros/Cons, Argument map, attachments, Stop, saved chats, save to Library
• ✅ Crossfire: both modes, styles, seed questions, signals, debrief, voice, saved rounds (read only; the website can't open them at all)
• 🆕 Sparring model picker (the website's ModelSelector feature="sparring")
• ✅ Sparring: format, side, order, cost, clock, judge, scorecard, voice, resume, PDF
• 🆕 Sparring Word export beside the PDF
• ✅ Motion generator, speech time calculator
• 🆕 Printable flow sheet (/tools/debate-flow-sheet) as a PDF, from Practice and the iPad sidebar

Library

• ✅ Link with preview, note (queued offline), file import (txt, md, csv, json, pdf, docx), folders (create, rename, merge, delete, toggle), search, 8 sorts, type filter, Clear all, source view and edit, source quality
• ➖ Scan pages: not a website feature (the audit found no OCR in src/)

History

• ✅ Per-debate and unsorted lists, reopen chats, open rounds, delete cases and Sparring rounds, add to a debate
• 🆕 Delete a saved Crossfire round, from History and from the round

Flowchart

• ✅ Starter map, cards, links, build from a case, save, save as, saved maps, delete
• ➖ PNG export is a PDF of the map tree (React Flow's canvas is not on iOS); drag canvas / minimap replaced by role columns

Timer and free tools

• ✅ Seven formats, POIs, prep banks, overtime, grace, cues, custom formats, Live Activity with Pause/Next, time-up alert, lock-screen widget
• 🆕 Share a custom format as the website's ?custom= link, and open such a link in the app (codec moved to packages/core)

You (Settings)

• ✅ UI and output language, theme, plan card with billing states, Download my data, Delete all my data, Delete account, Sign out, Notifications
• 🆕 "N uses left, resets at HH:MM" (the website's DailyUsage)
• 🆕 "Signed in with Google / email / Apple"
• 🆕 A website (Stripe) plan links to debateowl.com to manage it; no prices or purchase links
• ➖ Admin page and environment switcher (admin/staging only); promo codes and Stripe checkout (App Review: digital purchases go through StoreKit)

Sharing and export

• ✅ PDF and Word for case, attack, brainstorm, factoids; copy; discuss; open share links; create share links (an iOS extra)
• ➖ Google Docs export: needs a Google Drive OAuth scope and token refresh in the app; Word and PDF go to Google Drive through the share sheet instead

Global

• ✅ en/es/hu, light/dark/system, Ollie's welcome and tour, offline reading and write queue, daily usage line, voice, model picker on every AI tool
• ➖ Workspaces: hidden on the website too (VITE_COLLABORATION_URL unset in production)

Screenshots

The key screens are PNG assets on the release, with all 405 in DebateOwl-r7-screenshots.zip.

Builds and minutes

• EAS builds:
  • acffe3ed: the pipeline test of the sideload profile, at 2361b759. It produced an installable-shaped IPA.
  • 2f4e3d5a: the final IPA, at 58825f3.
  • Builds this month: 5 of the free plan's 15.
• EAS Simulator: 0 minutes used. eas simulator:availability returns available: false for the pi-stack account (waitlist at expo.dev/services/simulators), and T3's MacBook device host failed to start. The screenshots are the web export instead, rendered at iPhone (390×844 @3x) and iPad landscape (1366×1024 @2x) sizes against staging with the Pro demo account and faked AI answers. They show layout, copy and colour, not native tab bars, sheets or gestures.

Verification

• npm run verify locally at the final code:
  • docs, lint and typecheck pass;
  • 953 unit tests pass;
  • collaboration tests pass;
  • 555 Edge Function tests pass;
  • the build and service worker check pass;
  • 47 desktop smoke e2e tests pass.
  • One test failed on the first run: "Ideas" is the same word in Spanish, so it's now on the allowlist.
  • GitHub Actions is billing-blocked, so this is a local pass, not a CI pass.
• The web-export screenshot script, signed in to staging: 405 shots, with no clipped text and no page errors in the final run of each group.
• Codex review:
  • r1 at af57794 found 2 issues, fixed in b14b3323 and db4554b5.
  • r2 at f1a5677 found 2 more in the round-1 fix, both fixed in 58825f3 with a test.
  • r3, on that last fix, stalled without a result and was cancelled. 58825f3 has not been reviewed by a second model.
• Not verified: the IPA on a real iPhone, native gestures and sheets, VoiceOver, Live Activities and widgets on device, and real-device frame rates.

Adam's to-do (not done here)

• Add debatelab://auth/callback to production Supabase's Auth › Redirect URLs, or Google sign-in in the IPA opens the website and the student has to close it.
• To get simulator screenshots next time, enable EAS Simulator for pi-stack or reconnect the MacBook device host in T3.

🤖 Generated with Claude Code

[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

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

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