docs(spectrum-ts): Add iMessage troubleshooting page

[Ryan Zhu (underthestars-zhy)]

---

^{Need help on this PR? Tag /codesmith with what you need. Autofix is disabled.}

Summary by CodeRabbit

• Documentation
  • Added iMessage troubleshooting guide covering send failures, error explanations, recipient allowlist requirements for Free/Pro plans, handle verification procedures, and resources for contacting support.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
Photon	🟡 Building	–	Jun 21, 2026, 6:37 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: a2f89a98-8563-4819-bf80-e1d5dd73ee3a

📥 Commits

Reviewing files that changed from the base of the PR and between ca5d7f6 and 882fc2e.

📒 Files selected for processing (2)

• docs-src/spectrum-ts/troubleshooting/imessage.mdx.vel
• docs.json

Disabled knowledge base sources:

• Linear integration is disabled

You can enable these sources in your CodeRabbit configuration.

---

📝 Walkthrough

Walkthrough

Adds a new iMessage troubleshooting documentation page (spectrum-ts/troubleshooting/imessage.mdx.vel) covering the "Target not allowed for this project" error, with remediation steps for Free/Pro shared-line allowlist and handle-mismatch scenarios, a "Still stuck?" CTA, and registers the page under a new "Troubleshooting" navigation group in docs.json.

Changes

iMessage Troubleshooting Documentation

Layer / File(s)	Summary
iMessage troubleshooting page content docs-src/spectrum-ts/troubleshooting/imessage.mdx.vel	New page with front matter, intro navigation guidance, a full "Target not allowed for this project" error section (Free/Pro allowlist explanation, two remediation paths via dashboard steps and debug.photon.codes, Apple support links), and a "Still stuck?" contact CTA with required info checklist.
Troubleshooting group wired into Spectrum nav docs.json	A new "Troubleshooting" group is inserted as a sibling after "Best Practices" in the Spectrum tab navigation, containing the new iMessage page path.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐇 Hoppity-hop through the error maze,
A new page lights the iMessage haze!
"Target not allowed?" — no need to despair,
Check your handle and register with care.
Shared lines and allow-lists, now crystal clear,
The troubleshooting bunny has landed here! 🌟

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch ryan/troubleshoot

---

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