Skip to content

[Frontend] Persistent notifications center #338

Description

@jobbykings

Background

Users have no persistent view of notifications; important updates are only transient and easily missed.

Scope

A persistent notifications center with unread state, real-time updates, and actions. Out of scope: email/push delivery.

Proposed Approach

  • Build the notifications center UI
  • Fetch/mark-read logic in useNotifications.ts
  • Wire real-time updates via WebSocket/polling
  • Make it accessible (aria-live)

Files to Modify

  • frontend/src/components/Notifications/ — notifications center UI
  • frontend/src/hooks/useNotifications.ts — fetch/mark-read/realtime logic
  • frontend/src/lib/ — API client wiring

Edge Cases

  • Unread counts update in real time
  • Mark-read/clear actions are optimistic + reconciled
  • Empty and loading states are handled

Dependencies

  • frontend/src/components/Notifications/
  • frontend/src/hooks/useNotifications.ts

Effort

M — ~2–3 days

Definition of Done

  • Notifications list with read/unread states
  • Real-time updates for new notifications
  • Mark-read and clear actions
  • Accessible (aria-live) and tested

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions