Notifications & Tasks Overview
Two in-app systems — a real-time notification center and an onboarding-task board with credit rewards.
Layers ships two distinct systems:
- Notifications — real-time in-app messages surfaced via the bell icon, optionally interactive (confirm / select an option / enter a value).
- Tasks — a generalized onboarding-task system that rewards organization credits when you complete milestones (currently scoped to onboarding).
Where they live
- Notification bell in the top nav — dropdown shows unread and archived notifications with "Mark all as read" and an archived toggle. Updates live via a realtime subscription.
- Onboarding tasks widget on the dashboard — lists outstanding onboarding tasks with credit reward amounts and CTAs.
There is no email, Slack, mobile push, SMS, or desktop-toast delivery for notifications today. The notification system is in-app only. Push notifications for the mobile app are deferred.
Notification types
| Type | Meaning |
|---|---|
broadcast | Informational, no response expected. |
confirmation | Binary decision (confirm / reject). |
selection | Pick one from a predefined list of options. |
input | Submit a typed value (text, number, or currency). |
Interactive types (confirmation, selection, input) reference an
allow-listed action_key that maps to a server endpoint; when the
user responds, Layers executes the action and records the outcome.
The current allow-list is small — approve_content,
reject_content, adjust_spend_cap, acknowledge.
Notification scopes
| Scope | Fan-out |
|---|---|
user | Single user's inbox. |
project | Every member of the project. |
organization | Every member of the organization. |
Priority
Each notification carries one of four priorities:
low, normal, high, urgent. Priority drives the default icon
(Info / Bell / AlertTriangle / AlertCircle) when one isn't explicitly
set. It does not trigger different delivery channels — all
notifications deliver in-app.