This Flutter application follows the Clean Architecture principles and utilizes the Bloc pattern for state management. The app fetches daily news from the News API, displays them, and provides the option to save news articles to a local SQLite database.
The project follows the Clean Architecture principles, separating the app into different layers:
- Presentation Layer: Contains the Flutter widgets, Blocs, and UI-related logic.
- Domain Layer: Contains business logic and use cases.
- Data Layer: Manages data sources such as APIs and local databases.
The app uses the Bloc pattern for state management. Blocs are responsible for managing the application's state and business logic.
The get_it package is used as a service locator for dependency injection. It helps manage the app's dependencies in a clean and organized way.
Retrofit is used for making API requests to the News API. It provides a type-safe way to interact with RESTful APIs.
The equatable package is employed for efficient comparison of Dart objects. This is particularly useful when working with Blocs and state changes.
The app uses the Floor library to interact with a local SQLite database. News articles can be saved to the local database for offline access.
-
Clone the repository:
git clone https://github.com/yunus6116/Flutter-Bloc-Clean-Architecture.git
-
Navigate to the project directory:
cd your-repo -
Add your News API key:
Open the lib/core/constants/constants.dart file and locate the newsAPIKey variable. Replace 'your_api_key_here' with your actual News API key. If you don't have an API key, you can obtain one by signing up on the News API website.
// lib/core/constants/constants.dart
const String newsAPIKey = 'your_actual_api_key';
Note: Keep your API key secure and do not share it publicly. Consider using environment variables or other secure methods to manage sensitive information in a production environment. -
Install dependencies:
flutter pub get
-
Run the app:
flutter run