cinny/docs/handoff/features/inbox-and-invites/HANDOFF.md

Inbox & invites — handoff

Summary

The inbox area covers invites, notification feed, and notification preferences. Sidebar Inbox tab routes to invites list and notifications history.

User-facing behavior

• View and accept/decline room invites
• Browse notification events (mentions, etc.)
• Per-room notification preference overrides

Architecture

client/inbox/
  Inbox.tsx — layout
  Invites.tsx — invite list (allInvitesAtom)
  Notifications.tsx — notification feed
ClientRoomsNotificationPreferences.tsx — bulk prefs

Key files

Path	Role
cinny/src/app/pages/client/inbox/Inbox.tsx	Inbox layout
cinny/src/app/pages/client/inbox/Invites.tsx	Invites UI
cinny/src/app/pages/client/inbox/Notifications.tsx	Notifications list
cinny/src/app/state/room-list/inviteList.ts	allInvitesAtom
cinny/src/app/pages/client/ClientRoomsNotificationPreferences.tsx	Room notif prefs
cinny/src/app/pages/client/sidebar/InboxTab.tsx	Sidebar entry
cinny/src/app/hooks/useRoomsNotificationPreferences.ts	Prefs hook

Data model

Source	Data
Sync	m.room.member invite membership
Account data	push rules, per-room notification prefs

Dependencies

• matrix-js-sdk sync invite events
• Push rule APIs

Integration points

• background-notifications: same push rules drive system notifications
• user-settings: notification settings tab
• routing-and-navigation: INBOX_PATH, _INVITES_PATH, _NOTIFICATIONS_PATH

Testing

Manual

1. Receive invite; appears in inbox.
2. Accept invite; room joins home list.
3. Decline invite; removed from list.
4. Notifications page shows recent highlights.

Automated

• None

Known issues & gotchas

• Invite list can desync briefly during sync gap
• Notification feed scope depends on push rules setup

Future work

• Mark all invites read
• Notification grouping by room

Related docs

• background-notifications HANDOFF
• user-settings HANDOFF

Add your extra things here

• getInboxInvitesPath, getInboxNotificationsPath in pathUtils