# autumncodes-hub/khabargaon architecture

> Architecture diagram of the GitHub repository autumncodes-hub/khabargaon, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/autumncodes-hub/khabargaon
- Repository: https://github.com/autumncodes-hub/khabargaon

## Overview

Jan Samachar is an Android news app whose documented core flow fetches US headlines, presents a refreshable, infinitely scrolling feed, and opens article details. Its README also describes locally saved favourites, article interactions, responsive phone/tablet layouts, and user-facing load errors. The tree identifies likely implementation components, but no runtime source was excerpted; edges below therefore reflect only README-documented relationships, not inferred calls between Kotlin modules.

Main entry points: [`app/src/main/java/com/example/khabargaon/ui/fragments/HeadlinesFragment.kt`](https://github.com/autumncodes-hub/khabargaon/blob/master/app/src/main/java/com/example/khabargaon/ui/fragments/HeadlinesFragment.kt) (Headlines feed), [`app/src/main/java/com/example/khabargaon/ui/fragments/ArticleFragment.kt`](https://github.com/autumncodes-hub/khabargaon/blob/master/app/src/main/java/com/example/khabargaon/ui/fragments/ArticleFragment.kt) (Article details), [`app/src/main/java/com/example/khabargaon/ui/fragments/FavouritesFragment.kt`](https://github.com/autumncodes-hub/khabargaon/blob/master/app/src/main/java/com/example/khabargaon/ui/fragments/FavouritesFragment.kt) (Favourites), [`app/src/main/java/com/example/khabargaon/api/NewsAPI.kt`](https://github.com/autumncodes-hub/khabargaon/blob/master/app/src/main/java/com/example/khabargaon/api/NewsAPI.kt) (News API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_news["News delivery"]
  node_news_activity["App activity<br/>[NewsActivity.kt]"]
  node_headlines["Headlines feed"]
  node_viewmodel["News ViewModel<br/>[NewsViewModel.kt]"]
  node_repository["News repository<br/>[NewsRepository.kt]"]
  node_news_api["News API client<br/>[NewsAPI.kt]"]
  node_error_display["Load errors<br/>[item_error.xml]"]
end

subgraph group_reading["Reading and engagement"]
  node_article_detail["Article details<br/>[ArticleFragment.kt]"]
  node_article_actions["Article interactions"]
end

subgraph group_storage["Local persistence"]
  node_favourites["Favourites"]
  node_article_store[("Article database<br/>[ArticleDatabase.kt]")]
  node_article_dao["Article DAO<br/>[ArticleDAO.kt]"]
end

node_reader(("App user"))
node_news_service["NewsAPI service"]

node_reader -->|"views headlines"| node_headlines
node_headlines -->|"fetches headlines"| node_news_service
node_reader -->|"refreshes feed"| node_headlines
node_headlines -->|"opens article"| node_article_detail
node_reader -->|"views favourites"| node_favourites
node_article_detail -->|"offers interactions"| node_article_actions
node_favourites -->|"reads saved articles"| node_article_store
node_news_service -->|"returns headlines"| node_news_api
node_headlines -->|"shows load errors"| node_error_display

click node_news_activity "https://github.com/autumncodes-hub/khabargaon/blob/master/app/src/main/java/com/example/khabargaon/ui/NewsActivity.kt"
click node_headlines "https://github.com/autumncodes-hub/khabargaon/blob/master/app/src/main/java/com/example/khabargaon/ui/fragments/HeadlinesFragment.kt"
click node_viewmodel "https://github.com/autumncodes-hub/khabargaon/blob/master/app/src/main/java/com/example/khabargaon/ui/fragments/NewsViewModel.kt"
click node_repository "https://github.com/autumncodes-hub/khabargaon/blob/master/app/src/main/java/com/example/khabargaon/repository/NewsRepository.kt"
click node_news_api "https://github.com/autumncodes-hub/khabargaon/blob/master/app/src/main/java/com/example/khabargaon/api/NewsAPI.kt"
click node_article_detail "https://github.com/autumncodes-hub/khabargaon/blob/master/app/src/main/java/com/example/khabargaon/ui/fragments/ArticleFragment.kt"
click node_article_actions "https://github.com/autumncodes-hub/khabargaon/blob/master/app/src/main/java/com/example/khabargaon/ui/fragments/CommentsFragment.kt"
click node_favourites "https://github.com/autumncodes-hub/khabargaon/blob/master/app/src/main/java/com/example/khabargaon/ui/fragments/FavouritesFragment.kt"
click node_article_store "https://github.com/autumncodes-hub/khabargaon/blob/master/app/src/main/java/com/example/khabargaon/db/ArticleDatabase.kt"
click node_article_dao "https://github.com/autumncodes-hub/khabargaon/blob/master/app/src/main/java/com/example/khabargaon/db/ArticleDAO.kt"
click node_error_display "https://github.com/autumncodes-hub/khabargaon/blob/master/app/src/main/res/layout/item_error.xml"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_news_activity,node_headlines,node_viewmodel,node_repository,node_news_api,node_error_display,node_reader toneBlue
class node_article_detail,node_article_actions toneAmber
class node_favourites,node_article_store,node_article_dao,node_news_service toneMint
```

## Components

### News delivery

- [App activity](https://github.com/autumncodes-hub/khabargaon/blob/master/app/src/main/java/com/example/khabargaon/ui/NewsActivity.kt): `app/src/main/java/com/example/khabargaon/ui/NewsActivity.kt`
- [Headlines feed](https://github.com/autumncodes-hub/khabargaon/blob/master/app/src/main/java/com/example/khabargaon/ui/fragments/HeadlinesFragment.kt): `app/src/main/java/com/example/khabargaon/ui/fragments/HeadlinesFragment.kt`
- [News ViewModel](https://github.com/autumncodes-hub/khabargaon/blob/master/app/src/main/java/com/example/khabargaon/ui/fragments/NewsViewModel.kt): `app/src/main/java/com/example/khabargaon/ui/fragments/NewsViewModel.kt`
- [News repository](https://github.com/autumncodes-hub/khabargaon/blob/master/app/src/main/java/com/example/khabargaon/repository/NewsRepository.kt): `app/src/main/java/com/example/khabargaon/repository/NewsRepository.kt`
- [News API client](https://github.com/autumncodes-hub/khabargaon/blob/master/app/src/main/java/com/example/khabargaon/api/NewsAPI.kt): `app/src/main/java/com/example/khabargaon/api/NewsAPI.kt`
- [Load errors](https://github.com/autumncodes-hub/khabargaon/blob/master/app/src/main/res/layout/item_error.xml): `app/src/main/res/layout/item_error.xml`

### Reading and engagement

- [Article details](https://github.com/autumncodes-hub/khabargaon/blob/master/app/src/main/java/com/example/khabargaon/ui/fragments/ArticleFragment.kt): `app/src/main/java/com/example/khabargaon/ui/fragments/ArticleFragment.kt`
- [Article interactions](https://github.com/autumncodes-hub/khabargaon/blob/master/app/src/main/java/com/example/khabargaon/ui/fragments/CommentsFragment.kt): `app/src/main/java/com/example/khabargaon/ui/fragments/CommentsFragment.kt`

### Local persistence

- [Favourites](https://github.com/autumncodes-hub/khabargaon/blob/master/app/src/main/java/com/example/khabargaon/ui/fragments/FavouritesFragment.kt): `app/src/main/java/com/example/khabargaon/ui/fragments/FavouritesFragment.kt`
- [Article database](https://github.com/autumncodes-hub/khabargaon/blob/master/app/src/main/java/com/example/khabargaon/db/ArticleDatabase.kt): `app/src/main/java/com/example/khabargaon/db/ArticleDatabase.kt`
- [Article DAO](https://github.com/autumncodes-hub/khabargaon/blob/master/app/src/main/java/com/example/khabargaon/db/ArticleDAO.kt): `app/src/main/java/com/example/khabargaon/db/ArticleDAO.kt`

### Other components

- **App user**
- **NewsAPI service**

## Connections

- App user → Headlines feed: views headlines (evidence: `README.md`)
- Headlines feed → NewsAPI service: fetches headlines (evidence: `README.md`)
- App user → Headlines feed: refreshes feed (evidence: `README.md`)
- Headlines feed → Article details: opens article (evidence: `README.md`)
- App user → Favourites: views favourites (evidence: `README.md`)
- Article details → Article interactions: offers interactions (evidence: `README.md`)
- Favourites → Article database: reads saved articles (evidence: `README.md`)
- NewsAPI service → News API client: returns headlines (evidence: `README.md`)
- Headlines feed → Load errors: shows load errors (evidence: `README.md`)
