diff --git a/docs/superpowers/specs/2026-07-17-topbar-unread-drawer-design.md b/docs/superpowers/specs/2026-07-17-topbar-unread-drawer-design.md new file mode 100644 index 0000000..183c08e --- /dev/null +++ b/docs/superpowers/specs/2026-07-17-topbar-unread-drawer-design.md @@ -0,0 +1,75 @@ +# Topbar Unread Drawer — Design + +Date: 2026-07-17 + +## Goal + +Add an "Unread" item to the topbar utilities, next to notifications. It shows +a live badge with the number of unread topics. Clicking it opens a dropdown +that lists recent unread topics. + +## Template + +New partial `templates/partials/header/unread-drawer.tpl`, imported in +`templates/partials/header/topbar.tpl` just before the notifications `
  • ` +(logged-in menu only). It follows the structure of the neighboring utility +dropdowns: + +- Toggle button: `fa-inbox` icon, `title="[[unread:title]]"`, badge + `{unreadCount.topic}`. + NodeBB core sends `unreadCount.topic` in header data and live-updates any + `component="unread/count"` badge over sockets, so the count needs no theme JS. +- Dropdown body: an empty `