📰 News App

A modern, feature-rich News Application built with Flutter, designed to keep you updated with the latest headlines from around the world.

✨ Features

• Browse News: Access breaking news and top headlines.
• Categories: Filter news by categories (Business, Entertainment, Health, Science, Sports, Technology).
• Offline Support: Cache news for offline reading.
• Search: Search for specific news articles.
• Dark/Light Mode: Seamless theme switching.
• Responsive Design: Optimized for various screen sizes.

🛠️ Tech Stack

This project leverages a robust stack of libraries and tools to ensure performance, scalability, and maintainability:

• Framework: Flutter
• Language: Dart
• State Management: Flutter Bloc & Hydrated Bloc
• Dependency Injection: GetIt
• Networking: Dio
• Routing: GoRouter
• Functional Programming: Dartz
• Local Storage: Shared Preferences
• UI/UX:
  • Skeletonizer (Loading effects)
  • Lottie (Animations)
  • Cached Network Image

📂 Project Structure

The project follows a Feature-First architecture to ensure scalability and separation of concerns:

lib/
├── core/           # Core functionality (Routes, Themes, Utils, Network)
├── features/       # Feature-based modules (e.g., get_news)
│   └── get_news/
│       ├── data/       # Data layer (Repositories, Data Sources, Models)
│       ├── domain/     # Domain layer (Entities, Use Cases)
│       └── presentation/ # UI layer (Blocs, Pages, Widgets)
├── main.dart       # Application entry point
└── utility.dart    # General utilities

📸 Screenshots

Light	Dark

🌐 API Source

This application uses the NewsAPI:

• API: https://newsapi.org
• Endpoint: newsApiLite
• You need an API key to fetch news articles.

🚀 Getting Started

Follow these steps to set up the project locally.

Prerequisites

• Flutter SDK
• Dart SDK
• An IDE (VS Code, Android Studio, or IntelliJ)

Installation

1. Clone the repository:

   git clone https://github.com/Mohamedismaell/News.git
   cd News_App

2. Install dependencies:

   flutter pub get

3. Run the app:

   flutter run

🧪 Testing

To run the tests:

flutter test

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the project
2. Create your Feature Branch
3. Commit your changes
4. Push to the Branch
5. Open a Pull Request