https://github.com/helloitshessam/transferlist
"UIKit project using MVVM, Clean Architecture, async, and Combine to fetch transfer lists."
https://github.com/helloitshessam/transferlist
async clean combine mvvm swift uikit
Last synced: over 1 year ago
JSON representation
"UIKit project using MVVM, Clean Architecture, async, and Combine to fetch transfer lists."
- Host: GitHub
- URL: https://github.com/helloitshessam/transferlist
- Owner: helloItsHEssam
- License: mit
- Created: 2023-11-04T18:26:33.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-11-06T23:29:01.000Z (over 2 years ago)
- Last Synced: 2025-01-23T11:35:52.733Z (over 1 year ago)
- Topics: async, clean, combine, mvvm, swift, uikit
- Language: Swift
- Homepage:
- Size: 1.03 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Transfer List 
## Description
This application is implemented using the **MVVM (Model-View-ViewModel)** pattern along with the **Clean Architecture**. It is structured into three separate modules: Data, Domain, and MediaListUIKit. These modules are organized in a Monorepo setup, managed using Swift Package Manager, and all the modules are kept within a single package.
## The tech stack used in this project 🛠
- UIKit
- MVVM + clean architecture
- Unit Test + MockURL
- async / await (Structured concurrency)
- Combine
- Http client (Alamofire)
- Image Cacher (Kingfisher)
## Tools
- Xcode 14.3.1
- Swift 5.8.1
## Screenshots 🌃
List | Detail
:-------------------------:|:-------------------------:
|
## MonoRepo
In a **Monorepo** setup, multiple related projects are stored in a **single repository**, making it easier to manage and share code between them.
[monorepo.tools](https://monorepo.tools)
## Modules
- **Data Module**: Contains implementations related to repository, network, and local storage.
- **Domain Module**: Consists of repository protocols, use cases, and entities.
- **MediaListUIKit Module**: Contains Colors, Fonts, and views.
For more detailed information about each module, you can refer to the following links:
[Data](Data/README.md)
[Domain](Domain/README.md)
[UI](UI/README.md)
## Clean Architecture + MVVM
- **Data Layer:** This layer includes repository implementations, network-related components, and local storage handling.
- **Domain Layer:** Here, you'll find repository protocol, use case (interactors), and entities that represent the core business logic and data structures.
- **Presentation Layer:** This layer is divided into view models (ViewModels) and views (Views) responsible for presenting the user interface and handling the user interactions.
## Presentation Layer
It's important to note that the **Presentation layer** is part of the **main app** and **is not organized as a separate module**.
In the Presentation section, the following key components are present:
1. **SceneDelegate:** This class manages the application's lifecycle. It begins by registering the necessary fonts. It also creates the container required for Dependency Injection, which is utilized by the `ViewModelFactory`.
2. **DIContainer (Dependency Injection Container):** This protocol is responsible for creating the desired use cases. It should be passed to view models that need these use cases.
By implementing `DIContainerImpl`, we fulfill the DIContainer protocol, and this is where everything needed to construct use cases is assembled.
3. **ViewModelFactory:** The purpose of this class is to create view models. It handles the creation of view models that may require specific use cases. In this scenario, views don't directly get involved in the construction of view models; instead, the ViewModelFactory takes care of it.
## Diagrams
## Roadmap
- [ ] Test
- [ ] UITest cases.
- [ ] Test plan.
### Contributing 🤝
Contributions, issues, and feature requests are welcome! Feel free to fork the repository and submit a pull request with your changes.
## License
Please check [LICENSE](LICENSE) for details.