Push Notifications

Gigmeister sends push notifications on web, iOS, and desktop so band-critical events reach you when you're away from the app — gig reminders, status changes, chat mentions, and shared inbox activity.

What Triggers a Notification

| Trigger | Default behaviour | |---------|--------------------| | Event reminder | Sent once, roughly 24 hours before the event, to anyone marked Playing or Maybe | | Event created | Someone adds a new gig or rehearsal to the calendar | | Event updated | Date, time, venue, or details change on an event you're attending | | Event cancelled | An event you're attending is cancelled | | Attendance needed | The band needs your RSVP on an event | | New mail thread | A new email lands in the shared inbox (owners + managers only) | | Mail @mention | Someone @-mentions you in a thread note | | Member joined | A new member joins your band | | Setlist updated | A setlist linked to an upcoming event changes | | Chat message | New messages in band chat |

Each trigger has a single on/off toggle in Settings > Notifications. Lead times for reminders are not configurable today — the cron sends one reminder per event per user, then records the send so the same person isn't re-notified.

Enabling Notifications

Web (PWA)

1. Open Settings > Notifications
2. Tap Enable Push Notifications
3. Accept the browser permission prompt

Web push uses the VAPID protocol — secure, standards-based, no third party.

iOS

The native iOS app uses Apple Push Notification service (APNs) for delivery:

1. The app asks for notification permission on first launch (or from Settings > Notifications)
2. Grant permission in the system prompt

Desktop

The desktop app routes notifications through your operating system's native notification center (macOS Notification Center, Windows Action Center). No separate setup — granting permission to the app at install time is enough.

Note

Android push notifications are not yet supported on the beta build. Use email reminders or the web PWA on Android until native push lands.

Per-Device

Push subscriptions are managed per-device, not per-account. Enabling notifications on your phone doesn't enable them on your laptop, and vice versa. Each device subscribes independently. Your category preferences in Settings > Notifications, on the other hand, are per-band and apply to every device.

Email Fallback

If a user doesn't have any push subscriptions active for an event reminder, the reminder is sent via email instead — so band members who haven't opted into push still get the heads-up.

Privacy

Notification payloads include the minimum content needed to be useful — a song title, a gig date, a sender name. Full message bodies and sensitive details stay inside the app. If your phone is locked, sensitive content does not appear in the lockscreen preview.