kudoleh / ios-clean-architecture-mvvm

Template iOS app using Clean Architecture and MVVM. Includes DIContainer, FlowCoordinator, DTO, Response Caching and one of the views in SwiftUI

Template iOS App using Clean Architecture and MVVM

iOS Project implemented with Clean Layered Architecture and MVVM. (Can be used as Template project by replacing item name “Movie”). More information in medium post: Medium Post about Clean Architecture + MVVM

Layers

• Domain Layer = Entities + Use Cases + Repositories Interfaces
• Data Repositories Layer = Repositories Implementations + API (Network) + Persistence DB
• Presentation Layer (MVVM) = ViewModels + Views

Dependency Direction

Note: Domain Layer should not include anything from other layers(e.g Presentation — UIKit or SwiftUI or Data Layer — Mapping Codable)

Architecture concepts used here

• Clean Architecture https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html
• Advanced iOS App Architecture https://www.raywenderlich.com/8477-introducing-advanced-ios-app-architecture
• MVVM
• Data Binding using Observable without 3rd party libraries
• Dependency Injection
• Flow Coordinator
• Data Transfer Object (DTO)
• Response Data Caching
• ViewController Lifecycle Behavior
• SwiftUI and UIKit view implementations by reusing same ViewModel (at least Xcode 11 required)
• Error handling examples: in ViewModel, in Networking
• CI Pipeline (Travis CI + Fastlane)

Includes

• Pagination
• Unit Tests for Use Cases(Domain Layer), ViewModels(Presentation Layer), NetworkService(Infrastructure Layer)
• Dark Mode
• Size Classes and UIStackView in Detail view
• SwiftUI example, demostration that presentation layer does not change, only UI (at least Xcode 11 required)

Networking

If you would like to reuse Networking from this example project as repository I made it availabe here

Views in Code vs Storyboard

This repository uses Storyboards (except one view written in SwiftUI). There is another similar repository but instead of using Storyboards, all Views are written in Code. It also uses UITableViewDiffableDataSource: iOS-Clean-Architecture-MVVM-Views-In-Code

How to use app

To search a movie, write a name of a movie inside searchbar and hit search button. There are two network calls: request movies and request poster images. Every successful search query is stored persistently.

Demo.mp4

Requirements

• Xcode Version 11.2.1+ Swift 5.0+

ios-clean-architecture-mvvm's Issues

Observable is not thread safe

Observable class is not thread-safe. As adding observer from different threads can cause crash.

How can I replace the Network part URLSession with Alamofire?

I want to use the Alamofire framework for http(s) request, how can I modify the Network part?

How to get status_code, status_message

Can you please make a video from Scratch

I am not understanding the structure of code flow.
can you please make a video from beginning to ending using storyboard design.

[Question] `Data` package depends on `Networking` package?

First of all, thank you for your brilliant work publishing your article and the example source code.

I have a question regarding the diagram in your article, according to your diagram, the dependency direction should be from the "Networking" package to "Data" package

However in your example code, Data is depending on Networking, is this a violation of dependency direction?

Is there a better way?

iOS-Clean-Architecture-MVVM/ExampleMVVM/Data/PersistentStorages/CoreDataStorage/CoreDataStorage.swift

Line 25 in a5afd66

fatalError("Unresolved error \(error), \(error.userInfo)")

Hi. I really appreciate your repository. I was wondering what you believe the best way to solve or propagate errors in this clean architecture would be, for a shipping application.

[Question] Any plans on updating the approach to use async/await instead of callbacks?

MoviesListViewController has Repository

iOS-Clean-Architecture-MVVM/ExampleMVVM/Presentation/MoviesScene/MoviesList/View/MoviesListViewController.swift

Line 19 in be7dcbd

private var posterImagesRepository: PosterImagesRepository?

Hi,

• I was wondering why the PosterImageRepository directly accesses the MoviesListViewController without going through a UseCase=(Domain). I'm confused by this part.
• I guess that it is because the fetchImage response type is a Data, so there is no need to go through the Domain, am i right?