docs(sentry): integration guide and CI environment configuration

- docs/SENTRY_INTEGRATION.md: comprehensive guide covering setup,
  environment variables, sampling rates, privacy configuration,
  and self-hosting considerations
- cloudflare-web-deploy.yml: pass VITE_SENTRY_DSN and
  VITE_SENTRY_ENVIRONMENT=production to deploy workflow
- prepare-tofu/action.yml: forward Sentry env vars through
  OpenTofu infrastructure actions
- changesets for Sentry integration and improved crash page

Author: Just-Insane

.changeset/error_page_with_report.md

@@ -0,0 +1,5 @@
+---
+default: minor
+---
+
+added error page making it easier to report errors when they occur in the field

.changeset/feat-sentry-integration.md

@@ -0,0 +1,5 @@
+---
+'default': minor
+---
+
+Add Sentry integration for error tracking and bug reporting

.github/actions/prepare-tofu/action.yml

@@ -16,10 +16,16 @@ runs:
   steps:
     - name: Setup app and build
       uses: ./.github/actions/setup
-      env:
-        VITE_IS_RELEASE_TAG: ${{ inputs.is_release_tag }}
       with:
         build: 'true'
+      env:
+        VITE_IS_RELEASE_TAG: ${{ inputs.is_release_tag }}
+        VITE_SENTRY_DSN: ${{ env.VITE_SENTRY_DSN }}
+        VITE_SENTRY_ENVIRONMENT: ${{ env.VITE_SENTRY_ENVIRONMENT }}
+        VITE_APP_VERSION: ${{ env.VITE_APP_VERSION }}
+        SENTRY_AUTH_TOKEN: ${{ env.SENTRY_AUTH_TOKEN }}
+        SENTRY_ORG: ${{ env.SENTRY_ORG }}
+        SENTRY_PROJECT: ${{ env.SENTRY_PROJECT }}
 
     - name: Setup OpenTofu
       uses: opentofu/setup-opentofu@9d84900f3238fab8cd84ce47d658d25dd008be2f # v1.0.8

.github/workflows/cloudflare-web-deploy.yml

@@ -56,6 +56,13 @@ jobs:
         uses: ./.github/actions/prepare-tofu
         with:
           is_release_tag: ${{ startsWith(github.ref, 'refs/tags/v') || (github.event_name == 'workflow_dispatch' && inputs.git_tag != '') }}
+        env:
+          VITE_SENTRY_DSN: ${{ secrets.VITE_SENTRY_DSN }}
+          VITE_SENTRY_ENVIRONMENT: production
+          VITE_APP_VERSION: ${{ github.ref_name }}
+          SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
+          SENTRY_ORG: ${{ secrets.SENTRY_ORG }}
+          SENTRY_PROJECT: ${{ secrets.SENTRY_PROJECT }}
 
       - name: Comment PR plan
         uses: dflook/tofu-plan@3f5dc358343fb58cd60f83b019e810315aa8258f # v2.2.3
@@ -82,6 +89,13 @@ jobs:
         uses: ./.github/actions/prepare-tofu
         with:
           is_release_tag: ${{ startsWith(github.ref, 'refs/tags/v') || (github.event_name == 'workflow_dispatch' && inputs.git_tag != '') }}
+        env:
+          VITE_SENTRY_DSN: ${{ secrets.VITE_SENTRY_DSN }}
+          VITE_SENTRY_ENVIRONMENT: production
+          VITE_APP_VERSION: ${{ github.ref_name }}
+          SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
+          SENTRY_ORG: ${{ secrets.SENTRY_ORG }}
+          SENTRY_PROJECT: ${{ secrets.SENTRY_PROJECT }}
 
       - name: Plan infrastructure
         run: tofu plan -input=false -no-color

Caddyfile

@@ -15,4 +15,6 @@
 	}
 
 	try_files {path} /index.html
-}
+
+        # Required for Sentry browser profiling (JS Self-Profiling API)
+        header Document-Policy "js-profiling"

contrib/nginx/cinny.domain.tld.conf

@@ -20,6 +20,9 @@ server {
     location / {
         root /opt/cinny/dist/;
 
+        # Required for Sentry browser profiling (JS Self-Profiling API)
+        add_header Document-Policy "js-profiling" always;
+
         rewrite ^/config.json$ /config.json break;
         rewrite ^/manifest.json$ /manifest.json break;