Real-Time Updates

Joyous delivers notifications instantly — no polling, no refreshing, no waiting for a batch email. When someone assigns you a card, mentions you in a comment, or changes a status, you see it in your inbox within seconds.

How it works

Joyous uses Supabase Realtime to push notifications to your browser the moment they're created. The system works in three layers:

1. InboxInitializer — When you load Joyous, a background component fetches your existing notifications and subscribes to a real-time channel for your user
2. Realtime subscription — Supabase pushes new notifications through a persistent WebSocket connection, so your browser receives them without making additional requests
3. Store update — New notifications are added to your local inbox store, instantly updating the UI

Unread count badge

The sidebar shows an unread count badge next to the Inbox link. This badge updates in real time as new notifications arrive, so you always know when something needs your attention — even if you're on a different page.

Auto-updating inbox list

When you're viewing the Inbox page, new notifications appear at the top of the list automatically. The first unread item is auto-selected so you can see its details immediately in the right panel.

Changes to existing notifications — like marking as read from another device — also sync in real time.

Real-time across the app

Real-time delivery isn't limited to the Inbox. Several other features use Supabase Realtime:

• Outcome updates — New status updates appear instantly in the feed
• Comments — Replies show up in real time on card and outcome pages
• Status changes — Board and list views reflect changes from other users

Next Steps

• Inbox Overview — Return to the full inbox overview
• Notification Types — Learn about each notification type