Add Sentry integration

.github/workflows/release.yml

@@ -29,6 +29,8 @@ jobs:
       MACOS_APPLE_ID: ${{ secrets.MACOS_APPLE_ID }}
       # App-specific password generated at appleid.apple.com for notarization.
       MACOS_APPLE_PASSWORD: ${{ secrets.MACOS_APPLE_PASSWORD }}
+      # Sentry project DSN used for production telemetry.
+      SENTRY_DSN: ${{ secrets.SENTRY_DSN }}
 
     steps:
       - uses: actions/checkout@v6

.gitignore

@@ -9,6 +9,9 @@ out/
 # Generated code.
 gen/
 
+# Local environment.
+.env
+
 # macOS metadata.
 .DS_Store
 

README.md

@@ -39,6 +39,9 @@ npm run build
 Builds a macOS app and `.dmg`. Signing and notarization need Apple credentials from the environment; without them the
 build still produces an unsigned `.dmg`.
 
+Production Sentry telemetry is included only when `SENTRY_DSN` is set during the build.
+Release builds read it from the `SENTRY_DSN` GitHub Actions secret.
+
 ## Project layout
 
 - **`src/main/`** — app lifecycle, window, tray, metrics, and process services; owns privileged work and the typed IPC.