# frank0ch0a/hackernewsiosexample architecture

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

- Interactive diagram: https://gitdiagram.com/frank0ch0a/hackernewsiosexample
- Repository: https://github.com/frank0ch0a/hackernewsiosexample

## Overview

This is a SwiftUI Hacker News reader. On launch or pull-to-refresh, the list view asks its view model to fetch articles; the repository attempts the remote source, filters previously deleted IDs, caches results, and falls back to cached articles on failure or offline use. Users can open linked stories in an in-app web view and swipe to delete posts. The graph covers the principal flow and persistence; the README documents the user-facing capabilities, while some view-model and storage details are represented only where the source index or excerpts support them.

Main entry points: [`HackerNewsExample/HackerNewsExample/Presentation/NewsListView.swift`](https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Presentation/NewsListView.swift) (News list), [`HackerNewsExample/HackerNewsExample/Repository/ArticleRepositoryImpl.swift`](https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Repository/ArticleRepositoryImpl.swift) (Repository implementation), [`HackerNewsExample/HackerNewsExample/Datasource/RemoteArticleDataSource.swift`](https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Datasource/RemoteArticleDataSource.swift) (Remote source), [`HackerNewsExample/HackerNewsExample/ViewModel/ ArticleViewModel.swift`](https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/ViewModel/%20ArticleViewModel.swift) (Article view model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Presentation"]
  node_app["App entry"]
  node_list["News list<br/>[NewsListView.swift]"]
  node_item["Article row"]
  node_web["In-app web view<br/>[WebView.swift]"]
  node_vm["Article view model"]
end

subgraph group_domain["Article workflow"]
  node_factory["Repository factory"]
  node_repo["Article repository"]
  node_repoimpl["Repository implementation"]
  node_usecase["Fetch use case"]
  node_article["Article model<br/>[Article.swift]"]
end

subgraph group_sources["Data sources"]
  node_remote["Remote source"]
  node_local["Local source"]
  node_monitor["Network monitor"]
end

subgraph group_persistence["Local persistence"]
  node_coredata["Core Data stack"]
  node_store[("Article store<br/>[contents]")]
end

subgraph group_networking["Networking"]
  node_network["Network service"]
end

node_user(("Reader"))
node_api{{"Hacker News API"}}

node_user -->|"views and interacts"| node_list
node_app -->|"shows"| node_list
node_list -->|"fetches and deletes"| node_vm
node_list -->|"renders"| node_item
node_list -->|"opens selected link"| node_web
node_vm -->|"requests articles"| node_repo
node_vm -->|"checks connectivity"| node_monitor
node_factory -->|"creates"| node_repoimpl
node_repoimpl -->|"fetches remotely"| node_remote
node_repoimpl -->|"reads and saves cache"| node_local
node_repoimpl -->|"filters deleted IDs"| node_coredata
node_usecase -->|"uses"| node_repo
node_remote -->|"requests data"| node_network
node_remote -->|"retrieves articles"| node_api
node_network -->|"sends HTTP request"| node_api
node_local -->|"reads and writes"| node_coredata
node_coredata -.->|"persists entities"| node_store
node_remote -->|"decodes"| node_article
node_local -->|"maps cached records"| node_article
node_item -->|"displays"| node_article

click node_app "https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/HackerNewsExampleApp.swift"
click node_list "https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Presentation/NewsListView.swift"
click node_item "https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Presentation/ArticleItemView.swift"
click node_web "https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Presentation/WebView.swift"
click node_vm "https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/ViewModel/%20ArticleViewModel.swift"
click node_factory "https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Factory/ArticleRepositoryFactory.swift"
click node_repo "https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Repository/ArticleRepository.swift"
click node_repoimpl "https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Repository/ArticleRepositoryImpl.swift"
click node_usecase "https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Domain/UseCases/FetchArticleUseCase.swift"
click node_article "https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Entity/Article.swift"
click node_remote "https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Datasource/RemoteArticleDataSource.swift"
click node_local "https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Datasource/LocalArticleDataSource.swift"
click node_monitor "https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Utils/NetworkMonitor.swift"
click node_coredata "https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Storage/CoreDataStack.swift"
click node_store "https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Storage/HackerNewsExample.xcdatamodeld/HackerNewsExample.xcdatamodel/contents"
click node_network "https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Network/NetworkService.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_app,node_list,node_item,node_web,node_vm toneBlue
class node_factory,node_repo,node_repoimpl,node_usecase,node_article toneAmber
class node_remote,node_local,node_monitor,node_api toneMint
class node_coredata,node_store toneRose
class node_network,node_user toneIndigo
```

## Components

### Presentation

- [App entry](https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/HackerNewsExampleApp.swift): `HackerNewsExample/HackerNewsExample/HackerNewsExampleApp.swift`
- [News list](https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Presentation/NewsListView.swift): `HackerNewsExample/HackerNewsExample/Presentation/NewsListView.swift`
- [Article row](https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Presentation/ArticleItemView.swift): `HackerNewsExample/HackerNewsExample/Presentation/ArticleItemView.swift`
- [In-app web view](https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Presentation/WebView.swift): `HackerNewsExample/HackerNewsExample/Presentation/WebView.swift`
- [Article view model](https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/ViewModel/%20ArticleViewModel.swift): `HackerNewsExample/HackerNewsExample/ViewModel/ ArticleViewModel.swift`

### Article workflow

- [Repository factory](https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Factory/ArticleRepositoryFactory.swift): `HackerNewsExample/HackerNewsExample/Factory/ArticleRepositoryFactory.swift`
- [Article repository](https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Repository/ArticleRepository.swift): `HackerNewsExample/HackerNewsExample/Repository/ArticleRepository.swift`
- [Repository implementation](https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Repository/ArticleRepositoryImpl.swift): `HackerNewsExample/HackerNewsExample/Repository/ArticleRepositoryImpl.swift`
- [Fetch use case](https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Domain/UseCases/FetchArticleUseCase.swift): `HackerNewsExample/HackerNewsExample/Domain/UseCases/FetchArticleUseCase.swift`
- [Article model](https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Entity/Article.swift): `HackerNewsExample/HackerNewsExample/Entity/Article.swift`

### Data sources

- [Remote source](https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Datasource/RemoteArticleDataSource.swift): `HackerNewsExample/HackerNewsExample/Datasource/RemoteArticleDataSource.swift`
- [Local source](https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Datasource/LocalArticleDataSource.swift): `HackerNewsExample/HackerNewsExample/Datasource/LocalArticleDataSource.swift`
- [Network monitor](https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Utils/NetworkMonitor.swift): `HackerNewsExample/HackerNewsExample/Utils/NetworkMonitor.swift`

### Local persistence

- [Core Data stack](https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Storage/CoreDataStack.swift): `HackerNewsExample/HackerNewsExample/Storage/CoreDataStack.swift`
- [Article store](https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Storage/HackerNewsExample.xcdatamodeld/HackerNewsExample.xcdatamodel/contents): `HackerNewsExample/HackerNewsExample/Storage/HackerNewsExample.xcdatamodeld/HackerNewsExample.xcdatamodel/contents`

### Networking

- [Network service](https://github.com/frank0ch0a/hackernewsiosexample/blob/main/HackerNewsExample/HackerNewsExample/Network/NetworkService.swift): `HackerNewsExample/HackerNewsExample/Network/NetworkService.swift`

### Other components

- **Reader**
- **Hacker News API**

## Connections

- Reader → News list: views and interacts (evidence: `README.md`)
- App entry → News list: shows (evidence: `HackerNewsExample/HackerNewsExample/HackerNewsExampleApp.swift`)
- News list → Article view model: fetches and deletes (evidence: `HackerNewsExample/HackerNewsExample/Presentation/NewsListView.swift`)
- News list → Article row: renders (evidence: `HackerNewsExample/HackerNewsExample/Presentation/NewsListView.swift`)
- News list → In-app web view: opens selected link (evidence: `HackerNewsExample/HackerNewsExample/Presentation/NewsListView.swift`)
- Article view model → Article repository: requests articles (evidence: `HackerNewsExample/HackerNewsExample/ViewModel/ ArticleViewModel.swift`)
- Article view model → Network monitor: checks connectivity (evidence: `HackerNewsExample/HackerNewsExample/ViewModel/ ArticleViewModel.swift`)
- Repository factory → Repository implementation: creates (evidence: `HackerNewsExample/HackerNewsExample/Factory/ArticleRepositoryFactory.swift`)
- Repository implementation → Remote source: fetches remotely (evidence: `HackerNewsExample/HackerNewsExample/Repository/ArticleRepositoryImpl.swift`)
- Repository implementation → Local source: reads and saves cache (evidence: `HackerNewsExample/HackerNewsExample/Repository/ArticleRepositoryImpl.swift`)
- Repository implementation → Core Data stack: filters deleted IDs (evidence: `HackerNewsExample/HackerNewsExample/Repository/ArticleRepositoryImpl.swift`)
- Fetch use case → Article repository: uses (evidence: `HackerNewsExample/HackerNewsExample/Domain/UseCases/FetchArticleUseCase.swift`)
- Remote source → Network service: requests data (evidence: `HackerNewsExample/HackerNewsExample/Datasource/RemoteArticleDataSource.swift`)
- Remote source → Hacker News API: retrieves articles (evidence: `HackerNewsExample/HackerNewsExample/Datasource/RemoteArticleDataSource.swift`)
- Network service → Hacker News API: sends HTTP request (evidence: `HackerNewsExample/HackerNewsExample/Network/NetworkService.swift`)
- Local source → Core Data stack: reads and writes (evidence: `HackerNewsExample/HackerNewsExample/Datasource/LocalArticleDataSource.swift`)
- Core Data stack → Article store: persists entities
- Remote source → Article model: decodes (evidence: `HackerNewsExample/HackerNewsExample/Datasource/RemoteArticleDataSource.swift`)
- Local source → Article model: maps cached records (evidence: `HackerNewsExample/HackerNewsExample/Datasource/LocalArticleDataSource.swift`)
- Article row → Article model: displays (evidence: `HackerNewsExample/HackerNewsExample/Presentation/ArticleItemView.swift`)
