Welcome to the Notification App, a Flutter application that demonstrates how to receive and display both push and local notifications. The app features two main screens and utilizes the BLoC (Business Logic Component) pattern for robust state management.
- Push Notification Handling: Receives and displays push notifications sent via Firebase Cloud Messaging (FCM).
- Local Notification Handling: Schedules and displays local notifications triggered within the app.
- Notification Listing: A home screen that displays a list of all received notifications.
- Notification Details: A dedicated screen to view the detailed content of a selected notification.
- BLoC State Management: Employs the BLoC pattern to manage the state of notifications and UI updates.
Please be aware that this project, in its current configuration, is not set up to run on iOS or other Apple products. The necessary configurations and setup for Firebase and local notifications on iOS have not been included in this version. Therefore, the application will likely not function as expected on these devices.
- Flutter CLI Installed: Ensure you have the Flutter command-line interface (CLI) installed and configured on your system. You can find installation instructions on the official Flutter website: https://flutter.dev/docs/get-started/install.
- Dart SDK: Flutter comes bundled with the Dart SDK, so installing Flutter will also install Dart.
- Firebase Project: To enable push notification functionality, you need to have a Firebase project created and configured.
- Clone the repository:
Open your terminal or command prompt and navigate to the directory where you want to clone the project. Then, run the following command, replacing
https://github.com/lauritaila/local_push_notifications_flutter.gitwith the actual URL of your project's repository:2.Navigate to the project directory: Once the repository is cloned, navigate into the project directory using the cd command:git clone https://github.com/lauritaila/local_push_notifications_flutter.git
3.Set up Firebase (for push notifications):cd local_push_notifications_flutter- Create a Firebase Project: Go to the Firebase Console (https://console.firebase.google.com/) and create a new project. Follow the on-screen instructions.
- <
7C09
strong>Add Firebase to your Flutter app (Android):
Follow the steps in the Firebase console to register your Android app, providing your app's package name (found in
android/app/build.gradleunderdefaultConfig/applicationId). Download thegoogle-services.jsonfile and place it in theandroid/appdirectory of your Flutter project. - Enable Firebase Cloud Messaging (FCM): In your Firebase project, navigate to "Project settings" -> "Cloud Messaging" and ensure that the FCM service is enabled.
- Install dependencies: Run the following command to install the project's dependencies:
flutter pub get
- Run the app: Connect a physical device (for push notifications to work correctly on iOS) or use an emulator/simulator. Then, run the Flutter app using the following command:
flutter run
The app follows a structured approach, separating concerns into different layers and utilizing the BLoC pattern within the presentation layer.
local_push_notifications_flutter/
├── lib/
│ ├── config/
│ │ ├── router/
│ │ │ └── app_router.dart # Defines the app's navigation routes
│ │ ├── theme/
│ │ │ └── app_theme.dart # Defines the app's theme and colors
│ │ └── local_notification/
│ │ └── local_notification_service.dart # Manages local notifications
│ ├── domain/
│ │ └── entities/
│ │ └── push_messages.dart # Defines the structure for notification data
│ ├── presentation/
│ │ ├── blocs/
│ │ │ └── notifications/
│ │ │ ├── notifications_bloc.dart # Manages the state of notifications
│ │ │ ├── notifications_event.dart # Defines events related to notifications
│ │ │ └── notifications_state.dart # Defines the different states of notifications
│ │ └── screens/
│ │ ├── details_screen.dart # Screen to display detailed notification content
│ │ └── home_screen.dart # Screen to list all received notifications
│ ├── firebase_options.dart # Configuration for Firebase
│ └── main.dart # Entry point of the application
├── android/
├── ios/
├── test/
└── pubspec.yaml # Project dependencies
The following dependencies are used in this project:
equatable: ^2.0.7: Helps in comparing objects for equality, especially useful in BLoC for state management.
firebase_core: ^3.13.0: Provides core functionality for Firebase integration.
firebase_messaging: ^15.2.5: Enables receiving and handling push notifications from Firebase Cloud Messaging.
flutter: sdk: flutter: The core Flutter SDK.
flutter_bloc: ^9.1.0: Implements the BLoC/Cubit pattern for state management.
go_router: ^15.1.1: A declarative routing package for Flutter that simplifies navigation.
flutter_local_notifications: ^19.1.0: Provides functionality for displaying local notifications.
Contributions are welcome! If you have any suggestions, bug reports, or would like to add new features, please feel free to open an issue or submit a pull request.