# nalexn/clean-architecture-swiftui architecture

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

- Interactive diagram: https://gitdiagram.com/nalexn/clean-architecture-swiftui
- Repository: https://github.com/nalexn/clean-architecture-swiftui

## Overview

This is a SwiftUI countries-browsing app: users load and search a country list, open country details, and can view a flag; data comes from the REST API and is persisted locally. The graph includes the documented deep-link, push-permission, image-loading, and system-event capabilities. README architecture statements support the high-level view/interactor/repository relationships; unsampled interactor implementations are not verified here, so those edges are marked dashed.

Main entry points: [`CountriesSwiftUI/Core/SystemEventsHandler.swift`](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Core/SystemEventsHandler.swift) (System Events), [`CountriesSwiftUI/UI/CountriesList/CountriesListView.swift`](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/UI/CountriesList/CountriesListView.swift) (Countries List), [`CountriesSwiftUI/DependencyInjection/DIContainer.swift`](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/DependencyInjection/DIContainer.swift) (Dependency Container), [`CountriesSwiftUI/Repositories/WebAPI/CountriesWebRepository.swift`](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Repositories/WebAPI/CountriesWebRepository.swift) (Countries API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Presentation"]
  node_countries_list["Countries List"]
  node_country_details["Country Details"]
  node_flag_view["Flag View"]
  node_image_view["Image View<br/>[ImageView.swift]"]
  node_error_view["Error View<br/>[ErrorView.swift]"]
end

subgraph group_application["Application"]
  node_app["App Entry<br/>[App.swift]"]
  node_environment["App Environment"]
  node_container["Dependency Container<br/>[DIContainer.swift]"]
  node_state["App State<br/>[AppState.swift]"]
  node_countries_interactor["Countries Interactor"]
  node_images_interactor["Images Interactor"]
  node_permissions_interactor["Permissions Interactor"]
  node_deep_links["Deep Links"]
  node_system_events["System Events"]
  node_push_handler["Push Handler"]
end

subgraph group_data["Data Access"]
  node_country_web["Countries API"]
  node_image_web["Images API"]
  node_push_web["Push Token API"]
  node_web_repository["HTTP Client"]
  node_countries_db["Countries Database"]
  node_model_container[("SwiftData Store")]
  node_country_models["Country Models<br/>[Country.swift]"]
  node_details_models["Details Models"]
end

subgraph group_shared["Shared Runtime"]
  node_store["State Store<br/>[Store.swift]"]
  node_loadable["Loadable State<br/>[Loadable.swift]"]
end

node_user(("User"))
node_restcountries{{"REST Countries"}}
node_image_service{{"Image Service"}}
node_platform{{"iOS Platform"}}

node_user -->|"browses"| node_countries_list
node_app -->|"bootstraps"| node_environment
node_environment -->|"configures"| node_container
node_environment -->|"configures"| node_model_container
node_environment -->|"creates"| node_system_events
node_container -->|"holds"| node_state
node_container -->|"provides"| node_countries_interactor
node_container -->|"provides"| node_images_interactor
node_container -->|"provides"| node_permissions_interactor
node_countries_list -.->|"requests data"| node_countries_interactor
node_country_details -.->|"requests details"| node_countries_interactor
node_countries_list -->|"observes"| node_state
node_country_details -->|"renders"| node_image_view
node_flag_view -->|"renders"| node_image_view
node_countries_list -->|"shows errors"| node_error_view
node_country_details -->|"shows errors"| node_error_view
node_countries_interactor -.->|"fetches countries"| node_country_web
node_countries_interactor -.->|"persists data"| node_countries_db
node_images_interactor -.->|"loads images"| node_image_web
node_permissions_interactor -->|"updates"| node_state
node_country_web -->|"calls"| node_web_repository
node_image_web -->|"uses"| node_web_repository
node_push_web -->|"uses"| node_web_repository
node_country_web -->|"requests data"| node_restcountries
node_countries_db -->|"reads and writes"| node_model_container
node_countries_db -->|"maps records"| node_country_models
node_countries_db -->|"stores details"| node_details_models
node_country_web -->|"decodes"| node_country_models
node_country_web -->|"decodes"| node_details_models
node_image_view -.->|"loads images"| node_images_interactor
node_image_view -->|"tracks loading"| node_loadable
node_countries_list -->|"tracks loading"| node_loadable
node_state -->|"held in"| node_store
node_system_events -->|"dispatches links"| node_deep_links
node_system_events -->|"coordinates"| node_push_handler
node_system_events -->|"resolves permission"| node_permissions_interactor
node_system_events -->|"provides token API"| node_push_web
node_deep_links -->|"updates routing"| node_state
node_push_handler -->|"opens link"| node_deep_links
node_platform -.->|"delivers events"| node_system_events
node_image_view -.->|"displays remote image"| node_image_service

click node_app "https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Core/App.swift"
click node_environment "https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/DependencyInjection/AppEnvironment.swift"
click node_container "https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/DependencyInjection/DIContainer.swift"
click node_state "https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Core/AppState.swift"
click node_countries_list "https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/UI/CountriesList/CountriesListView.swift"
click node_country_details "https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/UI/CountryDetails/CountryDetailsView.swift"
click node_flag_view "https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/UI/CountryDetails/ModalFlagView.swift"
click node_image_view "https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/UI/Common/ImageView.swift"
click node_error_view "https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/UI/Common/ErrorView.swift"
click node_countries_interactor "https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Interactors/CountriesInteractor.swift"
click node_images_interactor "https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Interactors/ImagesInteractor.swift"
click node_permissions_interactor "https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Interactors/UserPermissionsInteractor.swift"
click node_deep_links "https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Core/DeepLinksHandler.swift"
click node_system_events "https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Core/SystemEventsHandler.swift"
click node_push_handler "https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Core/PushNotificationsHandler.swift"
click node_country_web "https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Repositories/WebAPI/CountriesWebRepository.swift"
click node_image_web "https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Repositories/WebAPI/ImagesWebRepository.swift"
click node_push_web "https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Repositories/WebAPI/PushTokenWebRepository.swift"
click node_web_repository "https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Repositories/WebAPI/WebRepository.swift"
click node_countries_db "https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Repositories/Database/CountriesDBRepository.swift"
click node_model_container "https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Repositories/Database/ModelContainer.swift"
click node_country_models "https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Repositories/Models/Country.swift"
click node_details_models "https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Repositories/Models/CountryDetails.swift"
click node_store "https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Utilities/Store.swift"
click node_loadable "https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Utilities/Loadable.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_countries_list,node_country_details,node_flag_view,node_image_view,node_error_view,node_user toneBlue
class node_app,node_environment,node_container,node_state,node_countries_interactor,node_images_interactor,node_permissions_interactor,node_deep_links,node_system_events,node_push_handler toneAmber
class node_country_web,node_image_web,node_push_web,node_web_repository,node_countries_db,node_model_container,node_country_models,node_details_models toneMint
class node_store,node_loadable toneRose
class node_restcountries,node_image_service,node_platform toneIndigo
```

## Components

### Presentation

- [Countries List](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/UI/CountriesList/CountriesListView.swift): `CountriesSwiftUI/UI/CountriesList/CountriesListView.swift`
- [Country Details](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/UI/CountryDetails/CountryDetailsView.swift): `CountriesSwiftUI/UI/CountryDetails/CountryDetailsView.swift`
- [Flag View](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/UI/CountryDetails/ModalFlagView.swift): `CountriesSwiftUI/UI/CountryDetails/ModalFlagView.swift`
- [Image View](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/UI/Common/ImageView.swift): `CountriesSwiftUI/UI/Common/ImageView.swift`
- [Error View](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/UI/Common/ErrorView.swift): `CountriesSwiftUI/UI/Common/ErrorView.swift`

### Application

- [App Entry](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Core/App.swift): `CountriesSwiftUI/Core/App.swift`
- [App Environment](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/DependencyInjection/AppEnvironment.swift): `CountriesSwiftUI/DependencyInjection/AppEnvironment.swift`
- [Dependency Container](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/DependencyInjection/DIContainer.swift): `CountriesSwiftUI/DependencyInjection/DIContainer.swift`
- [App State](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Core/AppState.swift): `CountriesSwiftUI/Core/AppState.swift`
- [Countries Interactor](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Interactors/CountriesInteractor.swift): `CountriesSwiftUI/Interactors/CountriesInteractor.swift`
- [Images Interactor](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Interactors/ImagesInteractor.swift): `CountriesSwiftUI/Interactors/ImagesInteractor.swift`
- [Permissions Interactor](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Interactors/UserPermissionsInteractor.swift): `CountriesSwiftUI/Interactors/UserPermissionsInteractor.swift`
- [Deep Links](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Core/DeepLinksHandler.swift): `CountriesSwiftUI/Core/DeepLinksHandler.swift`
- [System Events](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Core/SystemEventsHandler.swift): `CountriesSwiftUI/Core/SystemEventsHandler.swift`
- [Push Handler](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Core/PushNotificationsHandler.swift): `CountriesSwiftUI/Core/PushNotificationsHandler.swift`

### Data Access

- [Countries API](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Repositories/WebAPI/CountriesWebRepository.swift): `CountriesSwiftUI/Repositories/WebAPI/CountriesWebRepository.swift`
- [Images API](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Repositories/WebAPI/ImagesWebRepository.swift): `CountriesSwiftUI/Repositories/WebAPI/ImagesWebRepository.swift`
- [Push Token API](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Repositories/WebAPI/PushTokenWebRepository.swift): `CountriesSwiftUI/Repositories/WebAPI/PushTokenWebRepository.swift`
- [HTTP Client](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Repositories/WebAPI/WebRepository.swift): `CountriesSwiftUI/Repositories/WebAPI/WebRepository.swift`
- [Countries Database](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Repositories/Database/CountriesDBRepository.swift): `CountriesSwiftUI/Repositories/Database/CountriesDBRepository.swift`
- [SwiftData Store](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Repositories/Database/ModelContainer.swift): `CountriesSwiftUI/Repositories/Database/ModelContainer.swift`
- [Country Models](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Repositories/Models/Country.swift): `CountriesSwiftUI/Repositories/Models/Country.swift`
- [Details Models](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Repositories/Models/CountryDetails.swift): `CountriesSwiftUI/Repositories/Models/CountryDetails.swift`

### Shared Runtime

- [State Store](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Utilities/Store.swift): `CountriesSwiftUI/Utilities/Store.swift`
- [Loadable State](https://github.com/nalexn/clean-architecture-swiftui/blob/master/CountriesSwiftUI/Utilities/Loadable.swift): `CountriesSwiftUI/Utilities/Loadable.swift`

### Other components

- **User**
- **REST Countries**
- **Image Service**
- **iOS Platform**

## Connections

- User → Countries List: browses
- App Entry → App Environment: bootstraps (evidence: `CountriesSwiftUI/Core/App.swift`)
- App Environment → Dependency Container: configures (evidence: `CountriesSwiftUI/DependencyInjection/AppEnvironment.swift`)
- App Environment → SwiftData Store: configures (evidence: `CountriesSwiftUI/DependencyInjection/AppEnvironment.swift`)
- App Environment → System Events: creates (evidence: `CountriesSwiftUI/DependencyInjection/AppEnvironment.swift`)
- Dependency Container → App State: holds (evidence: `CountriesSwiftUI/DependencyInjection/DIContainer.swift`)
- Dependency Container → Countries Interactor: provides (evidence: `CountriesSwiftUI/DependencyInjection/DIContainer.swift`)
- Dependency Container → Images Interactor: provides (evidence: `CountriesSwiftUI/DependencyInjection/DIContainer.swift`)
- Dependency Container → Permissions Interactor: provides (evidence: `CountriesSwiftUI/DependencyInjection/DIContainer.swift`)
- Countries List → Countries Interactor: requests data
- Country Details → Countries Interactor: requests details
- Countries List → App State: observes (evidence: `CountriesSwiftUI/UI/CountriesList/CountriesListView.swift`)
- Country Details → Image View: renders (evidence: `CountriesSwiftUI/UI/CountryDetails/CountryDetailsView.swift`)
- Flag View → Image View: renders (evidence: `CountriesSwiftUI/UI/CountryDetails/ModalFlagView.swift`)
- Countries List → Error View: shows errors (evidence: `CountriesSwiftUI/UI/CountriesList/CountriesListView.swift`)
- Country Details → Error View: shows errors (evidence: `CountriesSwiftUI/UI/CountryDetails/CountryDetailsView.swift`)
- Countries Interactor → Countries API: fetches countries
- Countries Interactor → Countries Database: persists data
- Images Interactor → Images API: loads images
- Permissions Interactor → App State: updates (evidence: `CountriesSwiftUI/Interactors/UserPermissionsInteractor.swift`)
- Countries API → HTTP Client: calls (evidence: `CountriesSwiftUI/Repositories/WebAPI/CountriesWebRepository.swift`)
- Images API → HTTP Client: uses (evidence: `CountriesSwiftUI/Repositories/WebAPI/ImagesWebRepository.swift`)
- Push Token API → HTTP Client: uses (evidence: `CountriesSwiftUI/Repositories/WebAPI/PushTokenWebRepository.swift`)
- Countries API → REST Countries: requests data (evidence: `CountriesSwiftUI/Repositories/WebAPI/CountriesWebRepository.swift`)
- Countries Database → SwiftData Store: reads and writes (evidence: `CountriesSwiftUI/Repositories/Database/CountriesDBRepository.swift`)
- Countries Database → Country Models: maps records (evidence: `CountriesSwiftUI/Repositories/Database/CountriesDBRepository.swift`)
- Countries Database → Details Models: stores details (evidence: `CountriesSwiftUI/Repositories/Database/CountriesDBRepository.swift`)
- Countries API → Country Models: decodes (evidence: `CountriesSwiftUI/Repositories/WebAPI/CountriesWebRepository.swift`)
- Countries API → Details Models: decodes (evidence: `CountriesSwiftUI/Repositories/WebAPI/CountriesWebRepository.swift`)
- Image View → Images Interactor: loads images
- Image View → Loadable State: tracks loading (evidence: `CountriesSwiftUI/UI/Common/ImageView.swift`)
- Countries List → Loadable State: tracks loading (evidence: `CountriesSwiftUI/UI/CountriesList/CountriesListView.swift`)
- App State → State Store: held in (evidence: `CountriesSwiftUI/DependencyInjection/AppEnvironment.swift`)
- System Events → Deep Links: dispatches links (evidence: `CountriesSwiftUI/Core/SystemEventsHandler.swift`)
- System Events → Push Handler: coordinates (evidence: `CountriesSwiftUI/Core/SystemEventsHandler.swift`)
- System Events → Permissions Interactor: resolves permission (evidence: `CountriesSwiftUI/Core/SystemEventsHandler.swift`)
- System Events → Push Token API: provides token API (evidence: `CountriesSwiftUI/Core/SystemEventsHandler.swift`)
- Deep Links → App State: updates routing (evidence: `CountriesSwiftUI/Core/DeepLinksHandler.swift`)
- Push Handler → Deep Links: opens link (evidence: `CountriesSwiftUI/Core/PushNotificationsHandler.swift`)
- iOS Platform → System Events: delivers events
- Image View → Image Service: displays remote image
