Skip to content

Simple application to demonstrate flutter app with clean architecture model.

License

Notifications You must be signed in to change notification settings

rahuljidgedev/headlines-app

Repository files navigation

Simple News Application

A simple News Proof of Concept (POC) application that displays top headlines from newsapi.org. The application utilizes the BLoC pattern, MVVM architecture, Dependency Injection, Retrofit, and ensures separation of concerns for Data layer, Domain layer, and Presentation layer.

Features

  • BLoC Pattern: Implements the Business Logic Component (BLoC) pattern for efficient state management.

  • MVVM Architecture: Adheres to the Model-View-ViewModel (MVVM) architectural pattern for a structured and maintainable codebase.

  • Dependency Injection: Utilizes Dependency Injection for efficient management and injection of dependencies.

  • Retrofit: Integrates Retrofit for making network requests and handling API responses.

  • Separation of Concerns: Ensures a clear separation of concerns for Data layer, Domain layer, and Presentation layer, enhancing code readability and maintainability.

Repository Contents

  • APK: You can find the installable APK for the application in the APK directory.

    • Images: Explore screenshots and images from the app in the Images directory.

Features

  • Displays a list of news articles
  • Each news article can be viewed in detail view mode.
  • Displays an error message if there is an error fetching data
  • Allows saving articles to local cache.
  • Displays a list of saved articles from cache.

Technology Stack

  • Android Studio
  • Flutter
  • Dart
  • MVVM
  • Use Cases
  • Retrofit (remote data)
  • Get_it (Dependency injection)
  • Floor

Getting Started

  1. Clone or download the project.
  2. Add your news api key (you can get it from News Api).
  3. Open the project in Android Studio.
  4. Build and run the application.

Contributing

Feel free to contribute to this project by creating pull requests.

License

This project is licensed under the Apache License 2.0.

Disclaimer

This project is intended for demonstration and educational purposes only and is not a complete or production-ready application.


About

Simple application to demonstrate flutter app with clean architecture model.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published