[Jinwoo-H]

	Files	Added	Deleted	Net
Test	2	$\color{#1a7f37}{\Huge{\mathbf{+}}}$​29	0	$\color{#1a7f37}{\Huge{\mathbf{+}}}$​29
Prod	8	$\color{#1a7f37}{\Huge{\mathbf{+}}}$​56	$\color{#cf222e}{\Huge{\mathbf{−}}}$​6	$\color{#1a7f37}{\Huge{\mathbf{+}}}$​50

Summary

• add one troubleshooting sentence below the README Android download link
• add a compact Android-only troubleshooting section to the desktop Mobile download step
• open the canonical full guide in the system browser and cover the link/copy with focused tests

The canonical full guide is in stablyai/orca-marketing-website#244, because onorca.dev docs are sourced from that repository.

Evidence

The STA-4498 screenshot is an Android Custom Tab stuck at 133.02 MB / 133.02 MB; the current GitHub release asset is exactly 133,018,667 bytes and returns HTTP 200. The APK itself parses as Android 7.0+ and includes ARM32, ARM64, x86, and x86_64 libraries, so the reported state precedes package installation and does not indicate an Orca download-backend or ABI failure.

Validation so far

• pnpm exec vitest run --config config/vitest.config.ts src/renderer/src/components/mobile/MobileHero.test.tsx src/renderer/src/components/mobile/MobilePage.test.tsx (31 tests)
• pnpm typecheck
• localization catalog, extraction, and coverage checks
• max-lines ratchet

Visual validation and independent review remain in progress while this PR is draft.

Closes #14827. Tracks STA-4498.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 60b7da01-5885-409c-99a2-b4257d3e75cd

📥 Commits

Reviewing files that changed from the base of the PR and between 1204a00 and c4884e7.

📒 Files selected for processing (1)

• README.md

🚧 Files skipped from review as they are similar to previous changes (1)

• README.md

Included review availability: Your plan includes up to 10 reviews per rolling hour; 7 remain after this review.

---

📝 Walkthrough

Walkthrough

Adds an Android installation guide URL and a shell action that opens it in the system browser. Propagates the action through MobilePage, MobilePageContent, and HeroFlow. Adds an Android-only install guide button with localized text and an external-link icon. Updates tests for callback wiring, Android rendering, and URL opening. Adds an installation-guide link to the README.

🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (2 warnings)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.
Description check	⚠️ Warning	The description explains the change, rationale, issue, evidence, and validation, but it omits most required template sections and visual proof.	Complete the required template sections, especially ELI5, What Changed, Why, Visual Proof, Review, Notes, and Checklist.

✅ Passed checks (3 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	The changes address issue #14827 by adding Android APK setup and troubleshooting guidance, opening the full guide, and covering the behavior with focused tests.
Out of Scope Changes check	✅ Passed	The README, mobile UI, browser-opening action, localization, and focused tests are directly related to the Android APK guidance objective.
Title check	✅ Passed	The title clearly and concisely describes the primary change: adding Android APK installation guidance.

---

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.}

[coderabbitai]

🧹 Nitpick comments (1)

src/renderer/src/components/mobile/MobileHero.test.tsx (1)

75-75: 🎯 Functional Correctness | 🔵 Trivial | 💤 Low value

The test correctly verifies the "Install guide" button invokes onOpenAndroidInstallGuide once. The added screen.queryByText(/full browser, not an in-app browser/) check asserts absence of text that does not appear anywhere in MobileAndroidInstallHelp or the surrounding render tree, so it always passes trivially and adds limited verification value. This does not block the change.

Also applies to: 123-123, 158-171

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: c53ef589-2485-4f86-a7e6-32a830d0de4b

📥 Commits

Reviewing files that changed from the base of the PR and between 85565a9 and b6bdd72.

📒 Files selected for processing (10)

• README.md
• src/renderer/src/components/mobile/MobileAndroidInstallHelp.tsx
• src/renderer/src/components/mobile/MobileHero.test.tsx
• src/renderer/src/components/mobile/MobileHero.tsx
• src/renderer/src/components/mobile/MobilePage.test.tsx
• src/renderer/src/components/mobile/MobilePage.tsx
• src/renderer/src/components/mobile/MobilePageContent.tsx
• src/renderer/src/components/mobile/mobile-platform-copy.ts
• src/renderer/src/components/mobile/use-mobile-install-actions.ts
• src/renderer/src/i18n/locales/en.json

Included review availability: Your plan includes up to 10 reviews per rolling hour; 9 remain after this review.