Settings & Preferences

BrewHoard provides settings to customize your experience. Manage notification preferences and configure Progressive Web App (PWA) options.

Settings Overview

Access your settings from the user menu or navigate directly to /settings. The settings are organized into sections:

Notification Settings

Control how and when BrewHoard sends you email notifications. Accessible at /settings/alerts.

Notification Types

Email Configuration Status

The settings page displays your email configuration status:

• Green indicator: Email notifications are configured and active
• Yellow indicator: Email notifications are not fully configured (may require server-side setup)

PWA Settings

Manage Progressive Web App features for an enhanced mobile experience. Accessible at /settings/pwa.

App Installation

Install BrewHoard as a standalone app on your device:

• Desktop: Click “Install App” in the browser address bar
• Mobile: Add to Home Screen from browser menu
• Benefits: Faster loading, offline support, full-screen experience

Storage Management

Monitor and manage app storage:

• View current storage usage (MB used / quota)
• Clear Cache: Remove cached data to free up space

App Updates

Manage application updates:

• Auto Updates: Toggle automatic update downloads
• Update notifications appear when new versions are available

Network Status

Real-time network connectivity indicator:

• Online: Connected to the internet, full functionality
• Offline: Using cached data, changes sync when reconnected

API Reference

Get Notification Preferences

GET /api/v1/notifications/preferences

Response:

{
  "preferences": {
    "email_enabled": true,
    "welcome_emails": true,
    "rating_emails": true,
    "collection_reminders": false
  },
  "email_config": {
    "enabled": true,
    "provider": "resend",
    "from": "noreply@brewhoard.com",
    "hasApiKey": true,
    "environment": "production"
  },
  "can_send_emails": true
}

Update Notification Preferences

PUT /api/v1/notifications/preferences
Content-Type: application/json

{
  "email_enabled": true,
  "welcome_emails": true,
  "rating_emails": false,
  "collection_reminders": true
}

Privacy Considerations

• Email notifications: Your email is only used for selected notification types
• Offline storage: Cached data stays on your device
• Account deletion: You can permanently delete your account and all data from the Profile page (GDPR compliant)

Account Deletion

Users can permanently delete their account and all associated data from the Profile page. This implements GDPR Article 17 (Right to Erasure).

How to Delete Your Account

1. Navigate to your Profile (click your avatar in the navigation)
2. Scroll to the Danger Zone section at the bottom
3. Click Delete Account
4. Type DELETE in the confirmation dialog
5. Click the confirmation button

What Gets Deleted

When you delete your account, all of the following data is permanently removed:

• Your user account and profile information
• All beers in your collection
• All ratings and tasting notes you’ve written
• All notification preferences
• All API keys
• All active sessions

This action is irreversible. Consider exporting your collection before deleting your account.

Related Documentation

• Collection - Collection management
• Authentication - Account deletion technical details
• Notifications API - Notification preferences API