Notifications & Communication

Push notifications and branded emails live on one Contacts screen. Two tabs — Notifications for push, Email for broadcasts — with audience pickers, personalization, and a Review Recipients step before sending.

🔔

A. Push Notifications

Send instant push alerts to every app user or to a hand-picked custom list. Title, message, audience — three fields and a confirm.

📲 Send a push

Director Dashboard → Contacts.
Make sure the Notifications tab is selected (the default).
Enter a Title (notifTitle).
Enter a Message (notifMessage).
Pick audience: Bulk sends to all athletes with push tokens; Custom shows a person list with checkboxes (Select All / Select None).
Tap Send Notification.
Confirm in the popup ("Send notification to X users?"). The push fires.

Tip: Push is the right channel for time-sensitive announcements (match call, schedule change). For longer-form news, use Email instead.

📧

B. Mass Email Broadcasts

A full email composer with subject, body, {name} personalization, a CTA button, and a Review Recipients step. Past sends appear in a real-time Broadcast History list below the composer.

✉️ Send a broadcast

Director Dashboard → Contacts → switch to the Email tab.
Enter a Subject.
Write your Body — use the {name} variable to personalize per-recipient.
Pick an Audience: All Members, Active (Linked), Invited Only, or Tournament (then pick the tournament).
(Optional) Toggle Show CTA, then enter ctaText and ctaUrl to add a button at the bottom.
Tap Preview to see the email with {name} interpolated to "John Smith".
Expand Review Recipients, uncheck anyone you don't want to email (Select All / Deselect All available).
Tap Send Broadcast and confirm. The send appears in Broadcast History below.

What's in Broadcast History

Date sent, subject line, recipient count, audience type.
Last 20 sends, real-time updated.
Reference for audit, follow-ups, or copying past campaigns.

📣

C. Tournament Alerts

When a player follows a venue, they automatically get notifications about new tournaments, schedule changes, and tagged media. No setup required on the director side.

⭐ How players opt in

Player opens the athlete portal → Venues.
They search or filter to find your venue.
They tap ☆ Follow on the venue card.
Your venue is added to their favoriteVenues list.
From then on, every new tournament you schedule at that venue auto-pushes to that player.

Other auto-alert triggers

Tournament status changes — "scheduled" → "in-progress" → "completed".
Player tagged in media — when a director uploads a photo tagged with the player.
Join request approved/denied — for venues that require approval.
Players control which categories they receive in their Push Notification Preferences on their profile.

🏃

D. Athlete Portal

Players get their own portal — a personalized home screen with stats, upcoming events, recent results, leagues, and award badges.

🏠 Sections on the athlete home

Tournament Overview — Championships, Tournaments, Record, Game Record, Win %, Awards.
StatsFilterBar — Organization, Sport, Tier dropdowns.
⚔️ Match Record — last 5 matches, "View all →".
📅 Upcoming Tournaments — next 3 scheduled at any org the player belongs to.
🏅 My Leagues — active and scheduled leagues with status badge.
🏆 Recent Results — last 5 tournaments with placement medal.
Organizations — per-org breakdown with next 3 tournaments per org.
Recent Media — grid of 6 tagged photos.
🎖️ Awards — badge gallery (6 most recent) + "View all →".

Tip: Each "View all →" link is a shortcut into the matching detail screen. The athlete home is a launchpad, not the only stats page.