Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rcaos/TVToday
iOS TV Shows app with TMDb Api. Combine, MVVM + Coordinator. Modular Architecture. Swift Package Manager
https://github.com/rcaos/TVToday
clean-architecture combine combine-framework coordinator coordinator-pattern dependency-injection ios ios-app modular-architecture mvvm spm swift swift-package-manager swift5 themoviedb themoviedb-api tmdb tmdb-api
Last synced: 2 months ago
JSON representation
iOS TV Shows app with TMDb Api. Combine, MVVM + Coordinator. Modular Architecture. Swift Package Manager
- Host: GitHub
- URL: https://github.com/rcaos/TVToday
- Owner: rcaos
- License: mit
- Created: 2019-10-03T00:00:28.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-10-30T21:29:04.000Z (3 months ago)
- Last Synced: 2024-10-30T22:23:31.436Z (3 months ago)
- Topics: clean-architecture, combine, combine-framework, coordinator, coordinator-pattern, dependency-injection, ios, ios-app, modular-architecture, mvvm, spm, swift, swift-package-manager, swift5, themoviedb, themoviedb-api, tmdb, tmdb-api
- Language: Swift
- Homepage:
- Size: 66.9 MB
- Stars: 169
- Watchers: 2
- Forks: 31
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- fucking-open-source-ios-apps - TVToday
README
[](https://opensource.org/licenses/MIT)
[](https://developer.apple.com/swift)
[](https://github.com/apple/swift-package-manager)
TVShows iOS app using the [TMDb API](https://www.themoviedb.org/).
## What I'm working on
- ✅ Migrate Networking layer from Combine to Async await
- ✅ Localize UI and requests to endpoint
- ✅ Support Dynamic Type
- ✅ Improve UseCases and Repositories use (Clear separation between Repositories and DataSources
- ✅ Moving from Realm to Core Data
- ✅ Add demo apps for feature modules.
- ✅ Fix testability on Schedulers
- ✅ Migrate from RxDataSources to UICollectionViewDiffableDataSource
- ✅ Migrate from RxSwift to Combine
## About modularization
In this project, I show you an approach to how you could structure your app.
In a real big app, you will have more and big dependencies.
During development time, compiling the whole app could take quite an amount of time.
Currently, the app is divided into 22 modules with 06 feature modules. [See](https://github.com/rcaos/TVToday/blob/master/Package.swift)
Each feature module has its own demo target with a custom demo entry point.
So you need to leverage your Unit tests, Snapshot Tests and Demo targets to save your time and boost your productivity.
## Built with
- Swift 5
- Async-await
- Clean + Modular Architecture
- Coordinator Pattern.
- MVVM
- Dependency Injection
- Kingfisher
- Core Data
- KeychainSwift
- Swift Package Manager
- Dark Mode support
- Dynamic Type support
- English and Spanish Localized
## Requirements
1. Xcode 15.0+
## Getting started
1. Clone this repository.
2. Open `App/TVToday.xcodeproj` and have fun.
## Testing
- I use plain tests and Snapshot tests
- Check the test Plan associated to the AppFeature to run all the availabe tests
## Snapshot Tests
Last snapshot tests were created using an Apple Silicon with `Xcode 15.0`, Simulator `iPhone SE (3rd generation) iOS 17.0 (21A328)`
> ⚠️ Warning: Snapshots must be compared using the exact same simulator that originally took the reference to avoid discrepancies between images.
## Project evolution
- Monolith: https://github.com/rcaos/TVToday/releases/tag/v0.3.0
- RxSwift + CocoaPods : https://github.com/rcaos/TVToday/releases/tag/v.0.4.0
- RxSwift + SPM + Tuist: https://github.com/rcaos/TVToday/releases/tag/v0.5.0
- Combine + SPM + Tuist https://github.com/rcaos/TVToday/releases/tag/v0.6.0
- Combine + SPM https://github.com/rcaos/TVToday/releases/tag/v.0.7.0
- Current branch: Async-await + SPM
## Screenshots
### Dynamic Type
## Dark Mode
## Light Mode
# Author
Jeans Ruiz, [email protected]