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.