From e00b45d7c9dee279731261ba07703d4c53308fbf Mon Sep 17 00:00:00 2001 From: lucas Date: Tue, 1 Sep 2026 22:59:02 -0300 Subject: [PATCH 1/3] docs(capacitor): Add troubleshooting entry for source maps with live 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 Claude-Session: https://claude.ai/code/session_011A88ncGk1uWbFZSpX5PGpS --- .../guides/capacitor/troubleshooting.mdx | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/docs/platforms/javascript/guides/capacitor/troubleshooting.mdx b/docs/platforms/javascript/guides/capacitor/troubleshooting.mdx index 7093bbd769123e..4f984042aed776 100644 --- a/docs/platforms/javascript/guides/capacitor/troubleshooting.mdx +++ b/docs/platforms/javascript/guides/capacitor/troubleshooting.mdx @@ -5,6 +5,25 @@ keywords: ["minimum version", "deployment target"] sidebar_order: 9000 --- +## Source Maps Not Linked When Using Live Reload + +When you run your app with live reload (for example, `ionic cap run android -l` or `npx cap run ios -l`), the app loads files from your local dev server instead of the production build in your `www` folder. Stack traces from events captured during a live reload session reference the dev server's URLs, such as `http://192.168.x.x:8100/vendor.js`, which don't match the source maps generated from your production build. + +Because of this mismatch, source maps won't apply to events captured over live reload, and you may see an error like this when validating a release with `sentry-cli`: + +``` +Uploaded artifacts do not include entry: ~/vendor.js +``` + +To verify that your source maps are set up correctly, test against a production build instead of a live reload session: + +```bash +ionic build --prod +npx cap sync +``` + +Then run the production build on your device or emulator and upload source maps from your `www` build output as usual. + ## Replay only shows a white Empty page Session Replay does not work correctly with `@ionic/angular`, `@ionic/vue`, or `@ionic/react` version `8.7.1` or newer. Pin these packages to version `8.7.0` to capture session replays. From 8909cbda68dd8f1915d3ee180643bf0f3b5bc6a6 Mon Sep 17 00:00:00 2001 From: LucasZF Date: Tue, 1 Sep 2026 23:15:42 -0300 Subject: [PATCH 2/3] Apply suggestion from @lucas-zimerman --- docs/platforms/javascript/guides/capacitor/troubleshooting.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/platforms/javascript/guides/capacitor/troubleshooting.mdx b/docs/platforms/javascript/guides/capacitor/troubleshooting.mdx index 4f984042aed776..9b106ebbe6e677 100644 --- a/docs/platforms/javascript/guides/capacitor/troubleshooting.mdx +++ b/docs/platforms/javascript/guides/capacitor/troubleshooting.mdx @@ -18,7 +18,7 @@ Uploaded artifacts do not include entry: ~/vendor.js To verify that your source maps are set up correctly, test against a production build instead of a live reload session: ```bash -ionic build --prod +ionic build configuration=production npx cap sync ``` From d593976e7149dc26e4e834388d15f37339b3aeec Mon Sep 17 00:00:00 2001 From: LucasZF Date: Wed, 2 Sep 2026 23:17:58 -0300 Subject: [PATCH 3/3] Apply suggestion from @lucas-zimerman --- docs/platforms/javascript/guides/capacitor/troubleshooting.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/platforms/javascript/guides/capacitor/troubleshooting.mdx b/docs/platforms/javascript/guides/capacitor/troubleshooting.mdx index 9b106ebbe6e677..d109609e991f76 100644 --- a/docs/platforms/javascript/guides/capacitor/troubleshooting.mdx +++ b/docs/platforms/javascript/guides/capacitor/troubleshooting.mdx @@ -18,7 +18,7 @@ Uploaded artifacts do not include entry: ~/vendor.js To verify that your source maps are set up correctly, test against a production build instead of a live reload session: ```bash -ionic build configuration=production +ionic build --configuration=production npx cap sync ```