Skip to content

Releases: fluttersdk/magic_notifications

v0.0.1-alpha.1

24 Mar 23:43

Choose a tag to compare

v0.0.1-alpha.1 Pre-release
Pre-release

✨ Core Features

  • Multi-channel notifications: Database (in-app), Push (OneSignal), Mail (contract)
  • Notify facade: Static API for sending, fetching, polling, preferences
  • NotificationManager: Singleton dispatcher with channel/driver orchestration
  • NotificationPoller: Timer-based background polling with pause/resume/stop
  • User preferences: Global channel toggles + per-type channel preferences
  • Optimistic updates: markAsRead, markAllAsRead, delete with API rollback

🔔 Push Notifications

  • OneSignalDriver: iOS/Android push via onesignal_flutter ^5.4.0
  • OneSignalWebDriver: Web push via JS interop with conditional imports
  • PushPromptDialog: Soft prompt widget before OS permission request
  • Push subscription: Permission state tracking, opt-in/opt-out

🔧 CLI Tools

  • install: Interactive wizard — config, pubspec, platform files, OneSignal setup
  • configure: Show/update notification settings
  • doctor: Health check with exit codes
  • test: Send test notifications (dry-run, database, push, mail)
  • channels: List channel status
  • uninstall: Remove plugin integration
  • publish: Copy config stub to consumer project

🏗️ Architecture

  • Contract-first design: Notification, NotificationChannel, Notifiable abstractions
  • Service Provider: Two-phase bootstrap (register + boot) with IoC bindings
  • Driver abstraction: Swappable push providers (OneSignal, FCM, etc.)
  • Config-driven: All settings via Magic ConfigRepository

📚 Documentation

  • Concise pub.dev-ready README with badges, features table, quick start
  • Comprehensive doc/ folder — installation, configuration, channels, drivers, preferences, CLI, architecture, Laravel backend
  • CLAUDE.md project guidance for AI-assisted development

pub.dev: https://pub.dev/packages/magic_notifications/versions/0.0.1-alpha.1