📰 DailyLens – Android News Application

A modern Android News App built with Jetpack Compose, MVVM & Retrofit.
Real-time news by category with clean UI, pull-to-refresh, and robust error handling.

---

✨ Highlights

• 📰 Real-time news updates
• ⚡ Smooth Jetpack Compose UI
• 🔄 Pull-to-refresh support
• 🌙 Light / Dark mode toggle
• 📱 Tablet compatibility
• 🚨 Error handling for API & network

---

This app delivers the latest news across multiple categories with a smooth, responsive UI and supports both light & dark mode along with tablet compatibility.

---

✨ Features

• 🗂️ Browse news by categories (Business, Sports, Technology, etc.)
• 🫟 Splash Screen with App Icon
• 🔄 Pull-to-refresh for latest updates
• ⚡ Fast & responsive UI using Jetpack Compose
• 🧠 MVVM architecture for clean and scalable code
• 🌐 API integration using Retrofit
• 🚨 Robust error handling (network issues, API limits, invalid responses)
• 🔗 Open full articles in browser
• 🌙 Light / Dark mode toggle
• 📱 Tablet mode compatibility
• 🎯 Minimal, modern UI design

---

📱 Tech Stack

Layer	Technology
UI	Jetpack Compose
Architecture	MVVM
Networking	Retrofit
Async	Kotlin Coroutines
State Mgmt	State / MutableState
Language	Kotlin

---

🏗️ Project Structure

📦 newspaperapp
┣ 📂 data
┃ ┗ 📜 NewsRepository.kt
┣ 📂 ui
┃ ┣ 📜 NewsScreen.kt
┃ ┣ 📜 NewsItem.kt
┃ ┗ 📜 NewsDetail.kt
┣ 📂 viewmodel
┃ ┗ 📜 NewsViewModel.kt
┣ 📂 network
┃ ┗ 📜 RetrofitInstance.kt
┗ 📜 MainActivity.kt

---

🧭 Architecture Overview

This app follows the MVVM (Model-View-ViewModel) architecture with a unidirectional data flow.

flowchart TD

    UI[Jetpack Compose UI]
    VM[NewsViewModel]
    Repo[NewsRepository]
    API[Retrofit API Service]
    Network[Remote API]

    UI -->|User Actions| VM
    VM -->|Requests Data| Repo
    Repo -->|API Call| API
    API -->|HTTP Request| Network
    Network -->|JSON Response| API
    API -->|Parsed Data| Repo
    Repo -->|Articles List| VM
    VM -->|UI State Update| UI

Loading

---

🔄 Data Flow Explanation

• UI Layer (Compose)
  Displays news and sends user interactions (refresh, category change)

• ViewModel (NewsViewModel)
  Handles UI state (loading, success, error) and communicates with repository

• Repository (NewsRepository)
  Fetches data from API and handles errors

• Network Layer (Retrofit)
  Executes HTTP requests and parses responses

---

⚡ State Handling Flow

flowchart LR

    Start[User Action / App Launch]
    Loading[Loading State]
    Success[Success State - Show Articles]
    Error[Error State - Show Message]

    Start --> Loading
    Loading --> Success
    Loading --> Error

Loading

---

🎬 Demo Videos

📹 App flow in mobile and tablet:

https://youtu.be/TcfplDax_m8?si=K_Gs6e-bRGGRmsd5

Demo Videos:

Sign.Up.mp4

Log-in.mp4

Category-selector.mp4

Home-news-category-page.mp4

news.details.mp4

profile.mp4

about-us-and-update-category.mp4

all-category-news.mp4

update-name-and-password.mp4

landscape.mode.mp4

without.internet.mp4

---

🔑 API Key Setup (IMPORTANT)

⚠️ This project does NOT include an API key for security reasons.

To run the app with full functionality:

1. Get your API key from a news provider (e.g., GNews / NewsAPI)
2. Open local.properties
3. Add:

NEWS_API_KEY=your_api_key_here

4. Ensure BuildConfig is configured to access this key

---

⚠️ Notes

• API rate limits may apply
• Internet connection required
• Some categories may return empty results depending on region
• API key is required for full functionality

---

🧠 Learnings / Highlights

• Implemented clean MVVM architecture
• Managed UI state effectively with Compose
• Handled real-world API failures gracefully
• Built responsive UI supporting multiple screen sizes
• Integrated dark/light theme handling

---

🔮 Future Improvements

• 🔍 Search functionality
• ❤️ Bookmark articles
• 🗄️ Room Database integration:
  • Offline caching of news
  • User authentication (Signup/Login)
• 🔔 Push notifications
• 📊 Better personalization & recommendations

---

📄 License

Copyright (c) 2026 Kunal

All rights reserved.

Unauthorized use, reproduction, or distribution of this software, in whole or in part, is strictly prohibited without prior written permission from the author.