How nalexn/clean-architecture-swiftui works
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: SystemEventsHandler.swift System Events · CountriesListView.swift Countries List · DIContainer.swift Dependency Container · CountriesWebRepository.swift Countries API
Components 29
Presentation
- Countries List
CountriesSwiftUI/UI/CountriesList/CountriesListView.swift - Country Details
CountriesSwiftUI/UI/CountryDetails/CountryDetailsView.swift - Flag View
CountriesSwiftUI/UI/CountryDetails/ModalFlagView.swift - Image View
CountriesSwiftUI/UI/Common/ImageView.swift - Error View
CountriesSwiftUI/UI/Common/ErrorView.swift
Application
- App Entry
CountriesSwiftUI/Core/App.swift - App Environment
CountriesSwiftUI/DependencyInjection/AppEnvironment.swift - Dependency Container
CountriesSwiftUI/DependencyInjection/DIContainer.swift - App State
CountriesSwiftUI/Core/AppState.swift - Countries Interactor
CountriesSwiftUI/Interactors/CountriesInteractor.swift - Images Interactor
CountriesSwiftUI/Interactors/ImagesInteractor.swift - Permissions Interactor
CountriesSwiftUI/Interactors/UserPermissionsInteractor.swift - Deep Links
CountriesSwiftUI/Core/DeepLinksHandler.swift - System Events
CountriesSwiftUI/Core/SystemEventsHandler.swift - Push Handler
CountriesSwiftUI/Core/PushNotificationsHandler.swift
Data Access
- Countries API
CountriesSwiftUI/Repositories/WebAPI/CountriesWebRepository.swift - Images API
CountriesSwiftUI/Repositories/WebAPI/ImagesWebRepository.swift - Push Token API
CountriesSwiftUI/Repositories/WebAPI/PushTokenWebRepository.swift - HTTP Client
CountriesSwiftUI/Repositories/WebAPI/WebRepository.swift - Countries Database
CountriesSwiftUI/Repositories/Database/CountriesDBRepository.swift - SwiftData Store
CountriesSwiftUI/Repositories/Database/ModelContainer.swift - Country Models
CountriesSwiftUI/Repositories/Models/Country.swift - Details Models
CountriesSwiftUI/Repositories/Models/CountryDetails.swift
Shared Runtime
- State Store
CountriesSwiftUI/Utilities/Store.swift - Loadable State
CountriesSwiftUI/Utilities/Loadable.swift
Other components
- User
- REST Countries
- Image Service
- iOS Platform
Connections 41
- User → Countries List: browses
- App Entry → App Environment: bootstraps
CountriesSwiftUI/Core/App.swift - App Environment → Dependency Container: configures
CountriesSwiftUI/DependencyInjection/AppEnvironment.swift - App Environment → SwiftData Store: configures
CountriesSwiftUI/DependencyInjection/AppEnvironment.swift - App Environment → System Events: creates
CountriesSwiftUI/DependencyInjection/AppEnvironment.swift - Dependency Container → App State: holds
CountriesSwiftUI/DependencyInjection/DIContainer.swift - Dependency Container → Countries Interactor: provides
CountriesSwiftUI/DependencyInjection/DIContainer.swift - Dependency Container → Images Interactor: provides
CountriesSwiftUI/DependencyInjection/DIContainer.swift - Dependency Container → Permissions Interactor: provides
CountriesSwiftUI/DependencyInjection/DIContainer.swift - Countries List → Countries Interactor: requests data
- Country Details → Countries Interactor: requests details
- Countries List → App State: observes
CountriesSwiftUI/UI/CountriesList/CountriesListView.swift - Country Details → Image View: renders
CountriesSwiftUI/UI/CountryDetails/CountryDetailsView.swift - Flag View → Image View: renders
CountriesSwiftUI/UI/CountryDetails/ModalFlagView.swift - Countries List → Error View: shows errors
CountriesSwiftUI/UI/CountriesList/CountriesListView.swift - Country Details → Error View: shows errors
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
CountriesSwiftUI/Interactors/UserPermissionsInteractor.swift - Countries API → HTTP Client: calls
CountriesSwiftUI/Repositories/WebAPI/CountriesWebRepository.swift - Images API → HTTP Client: uses
CountriesSwiftUI/Repositories/WebAPI/ImagesWebRepository.swift - Push Token API → HTTP Client: uses
CountriesSwiftUI/Repositories/WebAPI/PushTokenWebRepository.swift - Countries API → REST Countries: requests data
CountriesSwiftUI/Repositories/WebAPI/CountriesWebRepository.swift - Countries Database → SwiftData Store: reads and writes
CountriesSwiftUI/Repositories/Database/CountriesDBRepository.swift - Countries Database → Country Models: maps records
CountriesSwiftUI/Repositories/Database/CountriesDBRepository.swift - Countries Database → Details Models: stores details
CountriesSwiftUI/Repositories/Database/CountriesDBRepository.swift - Countries API → Country Models: decodes
CountriesSwiftUI/Repositories/WebAPI/CountriesWebRepository.swift - Countries API → Details Models: decodes
CountriesSwiftUI/Repositories/WebAPI/CountriesWebRepository.swift - Image View → Images Interactor: loads images
- Image View → Loadable State: tracks loading
CountriesSwiftUI/UI/Common/ImageView.swift - Countries List → Loadable State: tracks loading
CountriesSwiftUI/UI/CountriesList/CountriesListView.swift - App State → State Store: held in
CountriesSwiftUI/DependencyInjection/AppEnvironment.swift - System Events → Deep Links: dispatches links
CountriesSwiftUI/Core/SystemEventsHandler.swift - System Events → Push Handler: coordinates
CountriesSwiftUI/Core/SystemEventsHandler.swift - System Events → Permissions Interactor: resolves permission
CountriesSwiftUI/Core/SystemEventsHandler.swift - System Events → Push Token API: provides token API
CountriesSwiftUI/Core/SystemEventsHandler.swift - Deep Links → App State: updates routing
CountriesSwiftUI/Core/DeepLinksHandler.swift - Push Handler → Deep Links: opens link
CountriesSwiftUI/Core/PushNotificationsHandler.swift - iOS Platform → System Events: delivers events
- Image View → Image Service: displays remote image