diff --git a/platform-includes/sourcemaps/overview/javascript.capacitor.mdx b/platform-includes/sourcemaps/overview/javascript.capacitor.mdx
new file mode 100644
index 0000000000000..7947225f2da22
--- /dev/null
+++ b/platform-includes/sourcemaps/overview/javascript.capacitor.mdx
@@ -0,0 +1,48 @@
+## Uploading Source Maps
+
+The easiest way to configure uploading source maps is by using the Sentry Wizard:
+
+
+
+After choosing your Sentry project, the setup process will prompt you to select a framework. This step is crucial for configuring Sentry correctly. Make sure to choose the appropriate framework based on your project’s requirements.
+
+```example
+◆ Which framework, bundler or build tool are you using?
+│ ● Angular
+│ ○ Create React App
+│ ○ Next.js
+│ ○ Remix
+│ ● Webpack
+│ ● Vite (Select this if you are using Vite and you have access to your Vite config.)
+│ ● esbuild
+│ ○ Rollup
+│ ● tsc
+│ ○ I use another tool
+│ ○ I don't minify, transpile or bundle my code
+└
+```
+
+ If your project uses `Ionic build` for building your project, select the `tsc` option.
+
+
+## Manual Source Maps upload
+
+If you want to configure source maps upload manually, follow the guide for your bundler or build tool below.
+
+### Sentry Bundler Supporte
+
+- webpack
+- Rollup
+- Vite
+- esbuild
+
+### Guides
+
+- TypeScript (tsc)
+
+ If you're using one of webpack, Vite, Rollup or Esbuild, use the
+ corresponding Sentry plugin instead (see section "Sentry Bundler Support").
+
+- UglifyJS
+- SystemJS
+- [GitHub Actions](/product/releases/setup/release-automation/github-actions/)
diff --git a/platform-includes/sourcemaps/primer/javascript.capacitor.mdx b/platform-includes/sourcemaps/primer/javascript.capacitor.mdx
new file mode 100644
index 0000000000000..2b4dd533c8108
--- /dev/null
+++ b/platform-includes/sourcemaps/primer/javascript.capacitor.mdx
@@ -0,0 +1,3 @@
+To enable readable stack traces in your Sentry errors, you need to upload your source maps to Sentry.
+
+