# Telemetry Configuration # # LifeRPG includes an optional telemetry system to help improve the application # through anonymous usage analytics. All telemetry is: # # - Optional and user-controlled # - Anonymous (no personal data) # - Transparent (users can see what's collected) # - Privacy-first (can be disabled globally or per-user) # Global telemetry enable/disable # Set to 'false' to disable telemetry entirely for all users # Set to 'true' to allow users to opt-in individually TELEMETRY_ENABLED=true # Events that are collected when telemetry is enabled: # # User Actions: # - habit_created: When a user creates a new habit # - habit_completed: When a user completes a habit # - achievement_earned: When a user earns an achievement # - level_up: When a user levels up # # Feature Usage: # - analytics_heatmap: User views habit heatmap # - analytics_trends: User views completion trends # - analytics_breakdown: User views habit breakdown # - analytics_streaks: User views streak history # - analytics_weekly: User views weekly summary # - analytics_insights: User views performance insights # - feature_used: Generic feature usage tracking # # Technical Events: # - error_occurred: When errors happen (helps with debugging) # - page_view: Page navigation (frontend usage patterns) # - user_interaction: UI interaction patterns # # Data Collected: # - Event timestamps (when things happen) # - User ID (for aggregation, but data remains anonymous) # - Action types (what features are used) # - Numeric values (habit difficulty, XP amounts, counts) # - Error types (for debugging) # # Data NOT Collected: # - Personal information (names, emails, etc.) # - Habit titles or content # - User notes or personal data # - Location or device information # - IP addresses or tracking cookies # Example usage in .env file: # TELEMETRY_ENABLED=true # To disable telemetry completely, set: # TELEMETRY_ENABLED=false # Users can still opt out individually even when globally enabled