firebase_fcm_token 1.1.2 copy "firebase_fcm_token: ^1.1.2" to clipboard
firebase_fcm_token: ^1.1.2 copied to clipboard

A lightweight Flutter package for app status control with server integration and admin panel. Control your app remotely, show white screen when disabled, and manage everything through admin panel.

Firebase FCM Token Package Changelog #

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.1.0 - 2025-09-24 #

🎯 Major Update: App Status Controller Only #

  • BREAKING: Removed FCM token functionality - now focused only on app status control
  • NEW: Enhanced error logging system with detailed Flutter console messages
  • NEW: Improved admin panel with better UI/UX
  • REMOVED: Firebase dependencies - lighter package size
  • ENHANCED: Better error messages when app is disabled

Added #

  • 📝 Detailed Error Messages - Flutter console shows comprehensive error info when app disabled
  • 🎨 Enhanced UI Messages - Better formatted debug output with emojis and clear structure
  • 🔍 Network Error Handling - Detailed logging for connection issues
  • 📊 Status Refresh Logging - Track when app status is refreshed
  • 🚫 App Disabled Alerts - Clear error messages when app is remotely disabled

Removed #

  • ❌ Firebase Core dependency
  • ❌ Firebase Messaging dependency
  • ❌ FCM token management functionality
  • ❌ Device info tracking
  • ❌ Token registration features

Technical Changes #

  • Reduced package size by ~70%
  • Simplified API - only app status control
  • Better error handling and user feedback
  • Enhanced debugging capabilities

1.0.2 - 2024-01-09 #

Added #

  • 🎯 Complete Admin Panel with 4 main sections
    • Dashboard with real-time statistics and charts
    • Token management with advanced filtering and pagination
    • App status control with bulk operations
    • API logs monitoring with cleanup functionality
  • 📚 Comprehensive Documentation
    • PHPMyAdmin setup guide with step-by-step instructions
    • Production deployment guide with security best practices
    • Complete server configuration examples
  • 🔧 PHPMyAdmin Compatibility - Removed DELIMITER syntax issues
  • 🛡️ Enhanced Security
    • Rate limiting implementation
    • API key authentication system
    • Admin panel session management
    • IP whitelisting support
  • 📊 Advanced Monitoring
    • Health check endpoint
    • Detailed error logging system
    • Performance metrics tracking
    • Automatic cleanup procedures

Enhanced #

  • Admin Interface: Bootstrap 5.1.3 with responsive design
  • Database Schema: Optimized indexes and performance improvements
  • API Security: Enhanced authentication and validation
  • Error Handling: Comprehensive error logging and reporting
  • Documentation: Production-ready deployment guides

Fixed #

  • PHPMyAdmin DELIMITER syntax compatibility issues
  • Unused field warnings in database schema
  • Session management in admin panel
  • API response consistency

1.0.1 - 2025-09-24 #

Changed #

  • BREAKING: initialize() method now only requires appName parameter
  • Server URL is now handled internally with smart configuration system
  • Added FCMConfig class for advanced server URL management
  • Simplified API - no more need for users to manage server URLs

Added #

  • FCMConfig class with environment-based URL management
  • Support for custom server URLs (optional parameter)
  • Development/Production environment auto-detection
  • Comprehensive examples documentation (EXAMPLES.md)

Improved #

  • Better developer experience with simpler initialization
  • Internal server URL management
  • More flexible configuration options

1.0.0 - 2025-09-24 #

Added #

  • Initial release of firebase_fcm_token package
  • Firebase FCM token management with automatic server synchronization
  • App status control system with white screen protection
  • Cross-platform support (Android, iOS, Web)
  • MySQL database integration with PHP server APIs
  • Automatic token refresh and device tracking
  • Background and foreground message handling
  • Comprehensive API endpoints for token and app management
  • App status widgets (AppStatusWidget, AppStatusLoader, AppStatusWrapper)
  • FCMTokenModel for structured data handling
  • Complete server-side PHP implementation with REST APIs
  • Database schema with proper indexing and relationships
  • API logging system for monitoring and debugging
  • Token cleanup and maintenance procedures
  • Example app demonstrating all features
  • Comprehensive test suite
  • Detailed documentation and setup guides

Features #

  • FCM Service: Complete Firebase Cloud Messaging integration
  • API Service: RESTful communication with server backend
  • App Status Management: Real-time app enable/disable functionality
  • Token Lifecycle: Automatic token creation, updates, and cleanup
  • Cross-Platform: Support for Android, iOS, and Web platforms
  • Security: Input validation, SQL injection protection, and secure API design
  • Monitoring: Comprehensive logging and error tracking
  • Performance: Optimized database queries and efficient token management

Server APIs #

  • POST /api/fcm_token.php - Register/update FCM tokens
  • POST /api/app_status.php - Check application status
  • GET /api/get_tokens.php - Retrieve token lists with pagination
  • POST /api/delete_token.php - Delete tokens (soft/hard delete)
  • POST /api/update_app_status.php - Update application status

Database Schema #

  • fcm_tokens: Store FCM tokens with device and app information
  • app_status: Manage application enable/disable states
  • api_logs: Track API usage and performance metrics
  • notification_history: Store notification delivery history

Technical Specifications #

  • Minimum Dart SDK: 3.0.0
  • Minimum Flutter: 3.0.0
  • Firebase Core: ^2.24.2
  • Firebase Messaging: ^14.7.10
  • MySQL 5.7+ or 8.0+
  • PHP 7.4+ or 8.0+

Documentation #

  • Complete README with usage examples
  • API documentation with curl examples
  • Database setup and migration scripts
  • Security best practices guide
  • Troubleshooting and debugging guide

Testing #

  • Unit tests for FCMTokenModel
  • Widget tests for AppStatusWidget components
  • Integration test examples
  • Server API test scenarios

[Unreleased] #

Planned Features #

  • Firebase Analytics integration
  • Advanced notification scheduling
  • Multi-language notification support
  • Push notification templates
  • Advanced user segmentation
  • Real-time dashboard for token management
  • Notification delivery reports
  • A/B testing for notifications

Note: This changelog follows the Keep a Changelog format to ensure clear and consistent documentation of all changes made to the firebase_fcm_token package.

3
likes
145
points
16
downloads

Publisher

verified publishercinar.fun

Weekly Downloads

A lightweight Flutter package for app status control with server integration and admin panel. Control your app remotely, show white screen when disabled, and manage everything through admin panel.

Repository (GitHub)
View/report issues

Documentation

Documentation
API reference

License

MIT (license)

Dependencies

flutter, http, shared_preferences

More

Packages that depend on firebase_fcm_token