Inbox NTF-01
Every notification the person has received — from every app and from Substratal — with read and archived state.
| Who can use it | Self |
|---|---|
| Where it is | /inbox · link: https://hub.substratalapps.com/inbox or substratal://inbox |
| Available on | Web (PWA), iOS / iPadOS, Android, Windows, Linux (GNOME), macOS |
| Phase | Phase 2 |
What you can do here
- Open row — optimistic; badge decrements
- Archive — toast with Undo (PATCH state:read)
- Mark read / unread
Related guides
- Notifications and push — Your inbox, turning push on per device, and what security alerts mean.
- Substratal on Linux — Install and run the Hub on GNOME and other Linux desktops, how it signs in, how notifications arrive, and Linux-only tips.
On your platform
| App | Status | How it's built |
|---|---|---|
| Web (PWA) | — | List pane (resizable) + detail pane ≥ 768 px; single pane < 768 px |
| iOS / iPadOS | — | List in NavigationStack (iPad: split view) |
| Android | Planned | ListDetailPaneScaffold list pane |
| Windows | — | Page with list pane (ListView) + detail (list-detail) |
| Linux (GNOME) | — | Nested AdwNavigationSplitView list pane |
| macOS | — | Content column (List(selection:)) + detail column |
Status is reported by each app's repository; — means that app doesn't report it yet.
For developers: API calls
| Method | Path | What it does |
|---|---|---|
| GET | /applications | List the catalog (filtered by visibility rules) |
| GET | /users/{id}/notifications | List a User's notification inbox (self, the app's own key, or users.list) |
| GET | /users/{id}/notifications/unread-count | Count unread notifications, in total and per Application (self or the app's own key) |
| POST | /users/{id}/notifications/mark-read | Mark every unread notification matching the filters as read (self or the app's own key) |
| PATCH | /users/{id}/notifications/{notificationId} | Mark one notification read, unread, or archived (self or the app's own key) |
Every call sends Substratal-Version: 1. Paths are at the host root, with no /v1.