Skip to Content
Iris Saas Kit documentation is under construction.
SaaS FeaturesNotifications

Notifications

A comprehensive broadcast notification system that enables administrators to send announcements, updates, and alerts to all users or specific audience segments across your platform.

📢 Broadcast Notifications

Platform-Wide Messaging

Reach Your Users - Send important messages to your entire user base:

  • Announcement System - Share product updates, news, and important information
  • Targeted Audiences - Send to all workspaces or only subscribed users
  • Instant Delivery - Notifications appear immediately across all targeted workspaces
  • Rich Content - Support for formatted messages with markdown

Notification Types

Contextual Messaging - Different styles for different purposes:

  • Info - General announcements and updates
  • Success - Celebrate achievements and positive news
  • Warning - Alert users to important changes or deadlines
  • Error - Critical issues requiring immediate attention

📝 Admin Controls

Create Notifications

Easy Composition - Simple interface for creating messages:

  • Title & Message - Clear, concise notification content
  • Type Selection - Choose the appropriate notification style
  • Audience Targeting - Select all users or subscribed workspaces only
  • Action Buttons - Add optional call-to-action with custom URL

Draft Management

Work at Your Pace - Save and refine before sending:

  • Save as Draft - Prepare notifications without publishing
  • Edit Drafts - Refine content until ready to send
  • Preview Content - Review exactly what users will see
  • Publish When Ready - Send with confidence

Publishing Workflow

Controlled Distribution - Safe and intentional messaging:

  • Confirmation Dialog - Review before sending
  • Audience Preview - See who will receive the notification
  • One-Click Publish - Simple publishing process
  • Instant Distribution - Notifications delivered immediately

🎯 Audience Targeting

Segmentation Options

Reach the Right Users - Target your messages effectively:

  • All Workspaces - Broadcast to every workspace on your platform
  • Subscribed Only - Target only paying customers
  • Workspace Members - Every member of targeted workspaces receives the notification

Distribution System

Reliable Delivery - Notifications reach everyone:

  • Automatic Distribution - System handles delivery to all workspace members
  • Scalable Broadcasting - Handles large user bases efficiently
  • Complete Coverage - No user left out of important announcements

🔔 User Notification Center

Notification Inbox

Centralized Access - Users manage all their notifications:

  • Notification Page - Dedicated page for viewing all notifications
  • Tab Filtering - Switch between All, Unread, and Read views
  • Chronological Display - Newest notifications first
  • Load More - Pagination for notification history

Visual Indicators

Clear Communication - Easy to understand at a glance:

  • Unread Badge - Sidebar shows count of unread notifications
  • Type Icons - Color-coded icons for notification types
  • New Badge - Visual indicator for unread notifications
  • Source Label - Shows notifications from admin broadcasts

User Actions

Full Control - Users manage their notification status:

  • Mark as Read - Clear notifications after viewing
  • Mark as Unread - Keep important notifications highlighted
  • Action Buttons - Click through to linked content
  • View History - Access all past notifications

📊 Notification Management

Admin Dashboard

Complete Oversight - Manage all notifications in one place:

  • Notification List - See all sent and draft notifications
  • Status Badges - Distinguish between Draft and Published
  • Type Indicators - Visual markers for notification types
  • Quick Actions - Edit, publish, or delete notifications

Statistics Overview

Track Your Communications - Understand your notification activity:

  • Total Count - All notifications created
  • Draft Count - Notifications waiting to be published
  • Published Count - Successfully sent notifications
  • Audience Reach - See targeting information

✏️ Content Features

Rich Messaging

Expressive Content - Create engaging notifications:

  • Markdown Support - Format messages with emphasis and structure
  • Clear Titles - Attention-grabbing headlines
  • Detailed Messages - Room for comprehensive information
  • Action Links - Direct users to relevant content

Call-to-Action Buttons

Drive Engagement - Guide users to take action:

  • Custom Labels - Descriptive button text
  • External Links - Link to any URL
  • Visual Prominence - Buttons stand out in notifications
  • Easy Access - One click to destination

🔒 Access & Security

Admin Privileges

Secure Management - Protected administrative functions:

  • Super Admin Only - Only authorized admins can create notifications
  • Edit Protection - Published notifications cannot be modified
  • Delete Capability - Remove notifications when needed
  • Confirmation Required - Destructive actions require confirmation

User Boundaries

Appropriate Access - Users see only their notifications:

  • Workspace Scoped - Notifications tied to workspace membership
  • Personal Inbox - Each user has their own notification list
  • Read Status Tracking - Individual read status per user

⚡ Real-Time Updates

Live Synchronization

Instant Updates - Everything stays current:

  • Real-Time Delivery - Notifications appear without refresh
  • Live Counts - Unread badge updates automatically
  • Instant Read Status - Changes reflected immediately
  • No Polling - Efficient real-time subscriptions

Always Visible - Users always know when they have notifications:

  • Unread Count Badge - Shows number of unread notifications
  • Automatic Updates - Badge updates as notifications arrive
  • Quick Access - Click to view all notifications

🎨 User Experience

Clean Interface

Beautiful Design - Professional notification display:

  • Card Layout - Clear, organized notification cards
  • Type Colors - Blue, green, yellow, red for different types
  • Consistent Styling - Matches your application design
  • Responsive Design - Works perfectly on all devices

Empty States

Helpful Guidance - Clear messaging when no notifications:

  • No Notifications - Friendly message when inbox is empty
  • All Read - Confirmation when caught up
  • Tab-Specific - Appropriate messages for each filter

🚀 Scalability

Performance Optimized

Built for Growth - Handle any notification volume:

  • Efficient Aggregation - Fast unread counts without scanning all data
  • Paginated Loading - Load notifications as needed
  • Batch Distribution - Efficient multi-workspace delivery
  • Real-Time Subscriptions - Lightweight live updates

Large-Scale Broadcasting

Enterprise Ready - Send to thousands of users:

  • Automatic Pagination - Handles large workspace lists
  • Batch Processing - Efficient notification creation
  • Reliable Delivery - All users receive notifications

Integration Benefits

The notification system seamlessly integrates with other boilerplate features:

  • Authentication - Admin-only access for creating notifications
  • Workspace System - Notifications scoped to workspace members
  • Subscription Management - Target by subscription status
  • Admin Interface - Notification management in super-admin dashboard
  • User Dashboard - Notification center in workspace sidebar

This broadcast notification system provides a reliable, scalable way to communicate with your users, keeping them informed about important updates, announcements, and actions they need to take.

Last updated on