Notification Events
The closed notification event set lives in packages/backend/convex/notifications/validators.ts.
The closed notification event set lives in
packages/backend/convex/notifications/validators.ts.
Notifications are user-facing summaries, not an audit trail. Audit events remain the source of truth for security/admin history.
| Event | Category | Default in-app | Default email | Notes |
|---|---|---|---|---|
member.invited | member | on | off | Sent to workspace owners/admins when a teammate is invited. |
member.joined | member | on | off | Sent to workspace owners/admins when an invitation is accepted. |
member.role_changed | member | on | off | Sent to the affected user and workspace owners/admins. |
member.removed | member | on | off | Sent to the affected user and workspace owners/admins. |
billing.subscription_created | billing | on | off | Reserved for checkout/provider integrations. |
billing.subscription_updated | billing | on | off | Sent when billing grants add workspace capabilities. |
billing.subscription_canceled | billing | on | on | Sent when billing grants revoke workspace capabilities. |
billing.payment_failed | billing | on | on | Reserved for provider webhook integrations. |
organization.suspended | organization | on | on | Sent to workspace owners/admins after super-admin suspension. |
organization.reactivated | organization | on | on | Sent to workspace owners/admins after super-admin reactivation. |
security.sensitive_action_requested | security | on | on | Reserved for sensitive-action extensions. |
security.email_changed | security | on | on | Reserved for account email-change extensions. |
To add an event:
- Add it to
notificationEvents,notificationEventValidator, andnotificationEventDefaults. - Add UI labels in
apps/app/src/locales/*. - Add creation calls through
notifications/events.ts. - Update this reference file and the relevant docs under
docs/notifications.
Audit Event Catalog
The closed set of audit actions shipped by the starter. The source of truth is convex/audit/validators.ts (auditActionValidator and AUDIT_ACTION_CATEGORY). This is a minimal starter audit, not a compliance guarantee.
AI Agent Developer Experience (DX)
The Leave Localhost Starter is heavily optimized for AI-assisted development. We provide specific files and guidelines that AI agents (like Cursor, Copilot, Claude Code, and Codex) consume to write better, more consistent code that adheres to our project conventions.