TVToday

A modular iOS TV shows app built with Swift async/await, Clean Architecture, MVVM, and Coordinators, powered by the TMDb API.

TVToday is a learning-focused project that demonstrates how to structure a medium-sized iOS app using Swift Package Manager, feature modules, and a clear separation of concerns. Each feature is a standalone module with its own DI container and coordinator, making the code easier to test, navigate, and evolve.

Key features

Feature-based modular architecture (SPM)
Clean Architecture + MVVM + Coordinator pattern
Swift async/await networking
Core Data persistence
Snapshot + unit tests
Dynamic Type and Dark/Light Mode support
English and Spanish localization

Architecture at a glance

App entry: AppFeature composes the app and builds feature coordinators
Feature modules: each module exposes a Module entry point and its own DI container
Navigation: Coordinators per feature, with shared builders for cross-feature flows
Infrastructure: shared modules for networking, persistence, and UI

Module map

Feature modules:

AiringTodayFeature
PopularsFeature
SearchShowsFeature
AccountFeature
ShowDetailsFeature
ShowListFeature

Shared modules:

Networking
NetworkingInterface
Persistence
PersistenceLive
Shared
UI
KeyChainStorage

Dependency graph (high level)

mermaid
graph TD
  AppFeature -->|builds| AiringTodayFeature
  AppFeature -->|builds| PopularsFeature
  AppFeature -->|builds| SearchShowsFeature
  AppFeature -->|builds| AccountFeature
  AppFeature -->|builds| ShowDetailsFeature
  AppFeature -->|builds| ShowListFeature

  AiringTodayFeature --> ShowDetailsFeatureInterface
  PopularsFeature --> ShowDetailsFeatureInterface
  SearchShowsFeature --> ShowDetailsFeatureInterface
  SearchShowsFeature --> ShowListFeatureInterface
  AccountFeature --> ShowListFeatureInterface

  ShowDetailsFeature --> ShowDetailsFeatureInterface
  ShowListFeature --> ShowListFeatureInterface

  ShowDetailsFeatureInterface --> Shared
  ShowDetailsFeatureInterface --> Networking
  ShowDetailsFeatureInterface --> Persistence

  ShowListFeatureInterface --> Shared
  ShowListFeatureInterface --> Networking
  ShowListFeatureInterface --> Persistence
  ShowListFeatureInterface --> UI

Why modularization?

This project shows how modularization can improve build times, test isolation, and team ownership. Each feature can be developed, tested, and demoed in isolation without rebuilding the entire app.

Who this is for

iOS developers learning modular architectures with Swift Package Manager
Engineers migrating from Combine/Rx to async/await
Anyone looking for a practical Clean Architecture + MVVM + Coordinator example

Project status

✅ 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