Skip to content

docs(capacitor): Add troubleshooting entry for source maps with live reload - #19231

Open
lucas-zimerman wants to merge 3 commits into
masterfrom
lz/cap-live-reload-troub
Open

docs(capacitor): Add troubleshooting entry for source maps with live reload#19231
lucas-zimerman wants to merge 3 commits into
masterfrom
lz/cap-live-reload-troub

Conversation

@lucas-zimerman

@lucas-zimerman lucas-zimerman commented Sep 2, 2026

Copy link
Copy Markdown
Collaborator

DESCRIBE YOUR PR

Adds a troubleshooting entry to the Capacitor docs explaining why source maps aren't linked to events captured while using live reload. When running with live reload, the app loads files from a local dev server instead of the production build that gets uploaded to Sentry, so the stack trace URLs won't match the uploaded source map artifacts.

  • Explains the cause (dev server vs. production build mismatch)
  • Shows the resulting sentry-cli "Uploaded artifacts do not include entry" error
  • Recommends testing against a production build (ionic build --prod + npx cap sync)

Closes getsentry/sentry-capacitor#270

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.
Select exactly one option. For deadlines, replace YYYY-MM-DD with the due date. You can update this information later by editing the PR description.

  • Urgent deadline (GA date, etc.): YYYY-MM-DD
  • Other deadline: YYYY-MM-DD
  • No deadline: Not urgent, can wait up to 1 week+

SLA

  • Teamwork makes the dream work, so please add a reviewer to your PRs.
  • Please give the docs team up to 1 week to review your PR unless you've supplied a deadline.

Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

…reload

Explains why source maps don't link to events captured during live
reload, since the dev server serves different files than the
production build that gets uploaded to Sentry.

Closes getsentry/sentry-capacitor#270

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011A88ncGk1uWbFZSpX5PGpS
@vercel

vercel Bot commented Sep 2, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
sentry-docs Ready Ready Preview Sep 3, 2026 2:25am UTC
1 Skipped Deployment
Project Deployment Actions Updated
develop-docs Ignored Ignored Preview Sep 3, 2026 2:25am UTC

Request Review

@codeowner-assignment
codeowner-assignment Bot requested a review from a team September 2, 2026 02:01
@github-actions github-actions Bot added the Priority: Normal Docs review has no urgent deadline label Sep 2, 2026
Comment thread docs/platforms/javascript/guides/capacitor/troubleshooting.mdx Outdated
Comment thread docs/platforms/javascript/guides/capacitor/troubleshooting.mdx Outdated
Comment thread docs/platforms/javascript/guides/capacitor/troubleshooting.mdx Outdated
Comment thread docs/platforms/javascript/guides/capacitor/troubleshooting.mdx Outdated
Comment thread docs/platforms/javascript/guides/capacitor/troubleshooting.mdx
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Priority: Normal Docs review has no urgent deadline

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add Troubleshooting for live reload

2 participants