Feature/comprehensive sentry integration

.env.example

@@ -1,7 +1,35 @@
 # Example .env file for empower_flutter
 # Copy this file to .env and fill in your actual values
 
+# ========================================
+# Sentry Core Configuration
+# ========================================
 SENTRY_AUTH_TOKEN=your_auth_token
 SENTRY_DSN=your_dsn
-SENTRY_RELEASE=your_release_version_or_git_sha
+SENTRY_RELEASE=empower_flutter@9.14.0+1  # Format: appname@version+build
 SENTRY_ENVIRONMENT=your_environment
+
+# ========================================
+# Sentry Organization & Project
+# ========================================
+SENTRY_ORG=your-org-slug
+SENTRY_PROJECT=your-project-slug
+
+# ========================================
+# Optional: Size Analysis
+# ========================================
+# Enable automatic build size analysis uploads during release builds
+# When enabled, APK/AAB files are automatically uploaded to Sentry
+# for size tracking and optimization insights
+# Requires sentry-cli to be installed (brew install sentry-cli)
+# Set to 'false' or comment out to disable (useful for faster local builds)
+SENTRY_SIZE_ANALYSIS_ENABLED=true
+
+# ========================================
+# Optional: CI/CD Metadata
+# ========================================
+# These are typically auto-detected in CI environments
+# CI_COMMIT_SHA=abc123
+# CI_MERGE_REQUEST_DIFF_BASE_SHA=def456
+# CI_COMMIT_REF_NAME=feature-branch
+# GITHUB_PR_NUMBER=42