# iamshekhargh/ai_article_summarizer architecture

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

- Interactive diagram: https://gitdiagram.com/iamshekhargh/ai_article_summarizer
- Repository: https://github.com/iamshekhargh/ai_article_summarizer

## Overview

This Android app lets users save articles, generate and revisit AI summaries, and organize saved items with search, tags, and favorites. The main documented structure runs from the app shell and Compose screens through ViewModels and domain use cases to a repository, local persistence, settings, and Gemini-backed data sources. The source excerpts and index show several links; unsampled implementation details are represented only where their subsystem is clear, with unverified links dashed.

Main entry points: [`app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/homeScreen/HomeScreen.kt`](https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/homeScreen/HomeScreen.kt) (Home navigation), [`app/src/main/java/com/shekharhandigol/aiarticlesummarizer/domain`](https://github.com/iamshekhargh/ai_article_summarizer/tree/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/domain) (Article use cases), [`app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/repoFiles/AiArticleSummarizerRepository.kt`](https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/repoFiles/AiArticleSummarizerRepository.kt) (Article repository), [`app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/repoFiles/LocalStorageDataSource.kt`](https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/repoFiles/LocalStorageDataSource.kt) (Local article source)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_activity["App shell<br/>[MainActivity.kt]"]
  node_navigation["Home navigation<br/>[HomeScreen.kt]"]
  node_input["Article input"]
  node_summary["Summary view<br/>[SummaryScreen.kt]"]
  node_library["Article library"]
  node_search["Search and tags<br/>[SearchScreen.kt]"]
  node_settings["Settings<br/>[SettingsScreen.kt]"]
  node_summaryvm["Summary controller"]
  node_searchvm["Search controller"]
end

subgraph group_domain["Article workflows"]
  node_usecases["Article use cases"]
  node_models["Article and summary models"]
end

subgraph group_data["Data and AI"]
  node_repository["Article repository"]
  node_remote["Gemini data source"]
  node_gemini["Gemini API client"]
  node_local["Local article source"]
  node_settingssource["Settings source"]
end

subgraph group_state["Persistence and preferences"]
  node_room[("Room database<br/>[AppDatabase.kt]")]
  node_articledao["Article records<br/>[ArticleDao.kt]"]
  node_summarydao["Summary records<br/>[SummaryDao.kt]"]
  node_preferences[("Settings preferences<br/>[DatastoreDao.kt]")]
end

node_user(("Reader"))
node_externalgemini{{"Gemini service"}}

node_user -->|"opens app"| node_activity
node_activity -->|"shows"| node_navigation
node_navigation -.->|"routes to"| node_input
node_navigation -.->|"routes to"| node_library
node_navigation -.->|"routes to"| node_search
node_navigation -.->|"routes to"| node_settings
node_input -->|"uses"| node_summaryvm
node_summary -->|"uses"| node_summaryvm
node_library -.->|"loads articles"| node_usecases
node_search -->|"uses"| node_searchvm
node_searchvm -->|"invokes"| node_usecases
node_summaryvm -.->|"invokes"| node_usecases
node_settings -.->|"updates settings"| node_usecases
node_usecases -->|"delegates to"| node_repository
node_repository -->|"delegates to"| node_remote
node_repository -->|"delegates to"| node_local
node_repository -->|"delegates to"| node_settingssource
node_local -->|"queries and writes"| node_articledao
node_local -->|"queries and writes"| node_summarydao
node_room -->|"provides"| node_articledao
node_room -->|"provides"| node_summarydao
node_settingssource -.->|"reads and writes"| node_preferences
node_remote -.->|"uses"| node_gemini
node_gemini -->|"sends prompts"| node_externalgemini

click node_activity "https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/MainActivity.kt"
click node_navigation "https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/homeScreen/HomeScreen.kt"
click node_input "https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/articleInputScreen/ArticleInputScreen.kt"
click node_summary "https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/summaryScreen/SummaryScreen.kt"
click node_library "https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/articlesHome/ArticleListScreen.kt"
click node_search "https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/searchScreen/SearchScreen.kt"
click node_settings "https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/settings/SettingsScreen.kt"
click node_summaryvm "https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/summaryScreen/SummaryScreenViewModel.kt"
click node_searchvm "https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/searchScreen/SearchScreenViewModel.kt"
click node_usecases "https://github.com/iamshekhargh/ai_article_summarizer/tree/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/domain"
click node_models "https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/core/ArticleWithSummaryUiModel.kt"
click node_repository "https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/repoFiles/AiArticleSummarizerRepository.kt"
click node_remote "https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/repoFiles/RemoteArticlesGeminiDataSource.kt"
click node_gemini "https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/GeminiApiService.kt"
click node_local "https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/repoFiles/LocalStorageDataSource.kt"
click node_room "https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/database/AppDatabase.kt"
click node_articledao "https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/database/ArticleDao.kt"
click node_summarydao "https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/database/SummaryDao.kt"
click node_preferences "https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/datastore/DatastoreDao.kt"
click node_settingssource "https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/repoFiles/SettingsDataSource.kt"

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_activity,node_navigation,node_input,node_summary,node_library,node_search,node_settings,node_summaryvm,node_searchvm toneBlue
class node_usecases,node_models toneAmber
class node_repository,node_remote,node_gemini,node_local,node_settingssource toneMint
class node_room,node_articledao,node_summarydao,node_preferences toneRose
class node_user,node_externalgemini toneIndigo
```

## Components

### App experience

- [App shell](https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/MainActivity.kt): `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/MainActivity.kt`
- [Home navigation](https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/homeScreen/HomeScreen.kt): `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/homeScreen/HomeScreen.kt`
- [Article input](https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/articleInputScreen/ArticleInputScreen.kt): `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/articleInputScreen/ArticleInputScreen.kt`
- [Summary view](https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/summaryScreen/SummaryScreen.kt): `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/summaryScreen/SummaryScreen.kt`
- [Article library](https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/articlesHome/ArticleListScreen.kt): `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/articlesHome/ArticleListScreen.kt`
- [Search and tags](https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/searchScreen/SearchScreen.kt): `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/searchScreen/SearchScreen.kt`
- [Settings](https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/settings/SettingsScreen.kt): `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/settings/SettingsScreen.kt`
- [Summary controller](https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/summaryScreen/SummaryScreenViewModel.kt): `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/summaryScreen/SummaryScreenViewModel.kt`
- [Search controller](https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/searchScreen/SearchScreenViewModel.kt): `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/searchScreen/SearchScreenViewModel.kt`

### Article workflows

- [Article use cases](https://github.com/iamshekhargh/ai_article_summarizer/tree/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/domain): `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/domain`
- [Article and summary models](https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/core/ArticleWithSummaryUiModel.kt): `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/core/ArticleWithSummaryUiModel.kt`

### Data and AI

- [Article repository](https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/repoFiles/AiArticleSummarizerRepository.kt): `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/repoFiles/AiArticleSummarizerRepository.kt`
- [Gemini data source](https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/repoFiles/RemoteArticlesGeminiDataSource.kt): `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/repoFiles/RemoteArticlesGeminiDataSource.kt`
- [Gemini API client](https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/GeminiApiService.kt): `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/GeminiApiService.kt`
- [Local article source](https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/repoFiles/LocalStorageDataSource.kt): `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/repoFiles/LocalStorageDataSource.kt`
- [Settings source](https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/repoFiles/SettingsDataSource.kt): `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/repoFiles/SettingsDataSource.kt`

### Persistence and preferences

- [Room database](https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/database/AppDatabase.kt): `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/database/AppDatabase.kt`
- [Article records](https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/database/ArticleDao.kt): `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/database/ArticleDao.kt`
- [Summary records](https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/database/SummaryDao.kt): `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/database/SummaryDao.kt`
- [Settings preferences](https://github.com/iamshekhargh/ai_article_summarizer/blob/master/app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/datastore/DatastoreDao.kt): `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/datastore/DatastoreDao.kt`

### Other components

- **Reader**
- **Gemini service**

## Connections

- Reader → App shell: opens app (evidence: `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/MainActivity.kt`)
- App shell → Home navigation: shows (evidence: `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/MainActivity.kt`)
- Home navigation → Article input: routes to
- Home navigation → Article library: routes to
- Home navigation → Search and tags: routes to
- Home navigation → Settings: routes to
- Article input → Summary controller: uses (evidence: `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/articleInputScreen/ArticleInputScreen.kt`)
- Summary view → Summary controller: uses (evidence: `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/summaryScreen/SummaryScreen.kt`)
- Article library → Article use cases: loads articles
- Search and tags → Search controller: uses (evidence: `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/searchScreen/SearchScreen.kt`)
- Search controller → Article use cases: invokes (evidence: `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/ui/searchScreen/SearchScreenViewModel.kt`)
- Summary controller → Article use cases: invokes
- Settings → Article use cases: updates settings
- Article use cases → Article repository: delegates to (evidence: `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/domain/SearchArticleUseCase.kt`)
- Article repository → Gemini data source: delegates to (evidence: `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/repoFiles/AiArticleSummarizerRepository.kt`)
- Article repository → Local article source: delegates to (evidence: `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/repoFiles/AiArticleSummarizerRepository.kt`)
- Article repository → Settings source: delegates to (evidence: `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/repoFiles/AiArticleSummarizerRepository.kt`)
- Local article source → Article records: queries and writes (evidence: `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/repoFiles/LocalStorageDataSource.kt`)
- Local article source → Summary records: queries and writes (evidence: `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/repoFiles/LocalStorageDataSource.kt`)
- Room database → Article records: provides (evidence: `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/database/AppDatabase.kt`)
- Room database → Summary records: provides (evidence: `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/database/AppDatabase.kt`)
- Settings source → Settings preferences: reads and writes (evidence: `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/repoFiles/SettingsDataSource.kt`)
- Gemini data source → Gemini API client: uses (evidence: `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/repoFiles/RemoteArticlesGeminiDataSource.kt`)
- Gemini API client → Gemini service: sends prompts (evidence: `app/src/main/java/com/shekharhandigol/aiarticlesummarizer/data/GeminiApiService.kt`)
