# joyalserrao/demoviper architecture

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

- Interactive diagram: https://gitdiagram.com/joyalserrao/demoviper
- Repository: https://github.com/joyalserrao/demoviper

## Overview

DemoVIPER is an iOS news-headlines app organized around a VIPER-style Today News screen. The scene delegate builds the module; the view forwards loading, paging, and language-selection events to the presenter; the presenter requests pages through the interactor, which fetches and decodes NewsAPI responses before returning articles for display. Article models and a reusable table cell support the listing. The README names no further capabilities. Edges follow shown calls or explicit references; unsampled utility behavior and app-delegate wiring are not inferred.

Main entry points: [`DemoVIPER/NewsModule/TodayNewsPresenter.swift`](https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/NewsModule/TodayNewsPresenter.swift) (News presenter), [`DemoVIPER/NewsModule/TodayNewsInteractor.swift`](https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/NewsModule/TodayNewsInteractor.swift) (News interactor), [`DemoVIPER/NewsModule/TodayNewsViewController.swift`](https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/NewsModule/TodayNewsViewController.swift) (News screen), [`DemoVIPER/NewsModule/TodayNewsRouter.swift`](https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/NewsModule/TodayNewsRouter.swift) (Module router)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["News presentation"]
  node_scene["Scene setup"]
  node_router["Module router"]
  node_view["News screen"]
  node_presenter["News presenter"]
  node_interactor["News interactor"]
  node_cell["Article cell"]
end

subgraph group_data["News data"]
  node_network["HTTP client<br/>[NetworkAPI.swift]"]
  node_response["News response<br/>[TodaysNews.swift]"]
  node_article["Article model<br/>[Articles.swift]"]
  node_source["Source model<br/>[Source.swift]"]
end

subgraph group_support["Display support"]
  node_constants["News constants<br/>[Constant.swift]"]
  node_localization["Localization manager<br/>[Localized.swift]"]
  node_utilities["UI utilities<br/>[Utilities.swift]"]
end

node_user(("App user"))
node_newsapi["NewsAPI"]

node_user -->|"uses screen"| node_view
node_scene -->|"sets up"| node_router
node_router -->|"creates"| node_view
node_router -->|"wires"| node_presenter
node_router -->|"wires"| node_interactor
node_view -->|"forwards events"| node_presenter
node_presenter -->|"requests pages"| node_interactor
node_interactor -->|"sends request"| node_network
node_network -->|"requests headlines"| node_newsapi
node_interactor -->|"decodes result"| node_response
node_response -->|"contains articles"| node_article
node_article -->|"contains source"| node_source
node_interactor -->|"returns articles"| node_presenter
node_presenter -->|"updates display"| node_view
node_view -->|"configures rows"| node_cell
node_cell -->|"renders fields"| node_article
node_presenter -->|"reads defaults"| node_constants
node_presenter -->|"sets language"| node_localization
node_cell -->|"downloads image"| node_utilities

click node_scene "https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/SceneDelegate.swift"
click node_router "https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/NewsModule/TodayNewsRouter.swift"
click node_view "https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/NewsModule/TodayNewsViewController.swift"
click node_presenter "https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/NewsModule/TodayNewsPresenter.swift"
click node_interactor "https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/NewsModule/TodayNewsInteractor.swift"
click node_network "https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/NetworkLayer/NetworkAPI.swift"
click node_response "https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/Model/TodaysNews.swift"
click node_article "https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/Model/Articles.swift"
click node_source "https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/Model/Source.swift"
click node_cell "https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/TodayNewsCell.swift"
click node_constants "https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/Utilities/Constant.swift"
click node_localization "https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/Utilities/Localized.swift"
click node_utilities "https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/Utilities/Utilities.swift"

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_scene,node_router,node_view,node_presenter,node_interactor,node_cell,node_user toneBlue
class node_network,node_response,node_article,node_source toneAmber
class node_constants,node_localization,node_utilities,node_newsapi toneMint
```

## Components

### News presentation

- [Scene setup](https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/SceneDelegate.swift): `DemoVIPER/SceneDelegate.swift`
- [Module router](https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/NewsModule/TodayNewsRouter.swift): `DemoVIPER/NewsModule/TodayNewsRouter.swift`
- [News screen](https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/NewsModule/TodayNewsViewController.swift): `DemoVIPER/NewsModule/TodayNewsViewController.swift`
- [News presenter](https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/NewsModule/TodayNewsPresenter.swift): `DemoVIPER/NewsModule/TodayNewsPresenter.swift`
- [News interactor](https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/NewsModule/TodayNewsInteractor.swift): `DemoVIPER/NewsModule/TodayNewsInteractor.swift`
- [Article cell](https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/TodayNewsCell.swift): `DemoVIPER/TodayNewsCell.swift`

### News data

- [HTTP client](https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/NetworkLayer/NetworkAPI.swift): `DemoVIPER/NetworkLayer/NetworkAPI.swift`
- [News response](https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/Model/TodaysNews.swift): `DemoVIPER/Model/TodaysNews.swift`
- [Article model](https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/Model/Articles.swift): `DemoVIPER/Model/Articles.swift`
- [Source model](https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/Model/Source.swift): `DemoVIPER/Model/Source.swift`

### Display support

- [News constants](https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/Utilities/Constant.swift): `DemoVIPER/Utilities/Constant.swift`
- [Localization manager](https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/Utilities/Localized.swift): `DemoVIPER/Utilities/Localized.swift`
- [UI utilities](https://github.com/joyalserrao/demoviper/blob/master/DemoVIPER/Utilities/Utilities.swift): `DemoVIPER/Utilities/Utilities.swift`

### Other components

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

## Connections

- App user → News screen: uses screen (evidence: `DemoVIPER/NewsModule/TodayNewsViewController.swift`)
- Scene setup → Module router: sets up (evidence: `DemoVIPER/SceneDelegate.swift`)
- Module router → News screen: creates (evidence: `DemoVIPER/NewsModule/TodayNewsRouter.swift`)
- Module router → News presenter: wires (evidence: `DemoVIPER/NewsModule/TodayNewsRouter.swift`)
- Module router → News interactor: wires (evidence: `DemoVIPER/NewsModule/TodayNewsRouter.swift`)
- News screen → News presenter: forwards events (evidence: `DemoVIPER/NewsModule/TodayNewsViewController.swift`)
- News presenter → News interactor: requests pages (evidence: `DemoVIPER/NewsModule/TodayNewsPresenter.swift`)
- News interactor → HTTP client: sends request (evidence: `DemoVIPER/NewsModule/TodayNewsInteractor.swift`)
- HTTP client → NewsAPI: requests headlines (evidence: `DemoVIPER/NetworkLayer/NetworkAPI.swift`)
- News interactor → News response: decodes result (evidence: `DemoVIPER/NewsModule/TodayNewsInteractor.swift`)
- News response → Article model: contains articles (evidence: `DemoVIPER/Model/TodaysNews.swift`)
- Article model → Source model: contains source (evidence: `DemoVIPER/Model/Articles.swift`)
- News interactor → News presenter: returns articles (evidence: `DemoVIPER/NewsModule/TodayNewsInteractor.swift`)
- News presenter → News screen: updates display (evidence: `DemoVIPER/NewsModule/TodayNewsPresenter.swift`)
- News screen → Article cell: configures rows (evidence: `DemoVIPER/NewsModule/TodayNewsViewController.swift`)
- Article cell → Article model: renders fields (evidence: `DemoVIPER/TodayNewsCell.swift`)
- News presenter → News constants: reads defaults (evidence: `DemoVIPER/NewsModule/TodayNewsPresenter.swift`)
- News presenter → Localization manager: sets language (evidence: `DemoVIPER/NewsModule/TodayNewsPresenter.swift`)
- Article cell → UI utilities: downloads image (evidence: `DemoVIPER/TodayNewsCell.swift`)
