https://github.com/telemtobi/movies-tca
Explore "The Composable Architecture" principles using TheMoviesDB API, focusing on modularity and predictability.
https://github.com/telemtobi/movies-tca
ios-app swift tca the-composable-architecture
Last synced: 11 days ago
JSON representation
Explore "The Composable Architecture" principles using TheMoviesDB API, focusing on modularity and predictability.
- Host: GitHub
- URL: https://github.com/telemtobi/movies-tca
- Owner: TelemTobi
- Created: 2023-11-06T15:55:08.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-22T08:20:18.000Z (about 1 month ago)
- Last Synced: 2025-04-15T12:19:03.737Z (11 days ago)
- Topics: ios-app, swift, tca, the-composable-architecture
- Language: Swift
- Homepage:
- Size: 33.5 MB
- Stars: 12
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## Movies-TCA
This project explores the concepts behind "The Composable Architecture" (TCA) using The Movie Database (TMDB) API. The focus is on building a modular and predictable application architecture for iOS development.
### The Composable Architecture (TCA)
[The Composable Architecture](https://github.com/pointfreeco/swift-composable-architecture) is a unidirectional and state management framework for iOS development. It emphasizes building applications from small, reusable, and testable pieces. TCA applications are built around a central state type, an action type that describes user interactions and events, and a reducer function that updates the state based on dispatched actions. This architecture promotes modularity, maintainability, and easier testing of your application logic.
**This project is constantly updated to stay compatible with the latest releases of TCA.**
### Getting Started
**Prerequisites:**
* macOS with Xcode 14 or later
* Basic understanding of Swift development
* Familiarity with The Composable Architecture framework
**Running the App:**
1. Clone the repository using Git:
```bash
git clone https://github.com/telemtobi/Movies-TCA.git
```
3. Open the `Movies-TCA.xcodeproj` file in Xcode.
4. (Optional) Configure your TMDB API access token in `Release.xcconfig`.
You can get an API access token by creating a free account on [TMDB]([https://www.themoviedb.org/account/signup](https://developer.themoviedb.org/reference/intro/getting-started)).
5. Build and run the app on your desired iOS device or simulator.
### Project Structure
The project is organized with a focus on modularity and separation of concerns:
* **App:** Contains the main application entry point (`MoviesApp.swift`).
* **Models:** Contains data models representing movie information.
* **Navigators:** Dedicated TCA features for handling navigation actions. This keeps each module's features isolated from navigation concerns.
* **Modules:** Houses individual TCA features representing specific parts of the application. Each module encapsulates its own state, actions, and reducer.
* **Networking:** Handles network requests and API interactions with TMDB. Consider referring to the companion package, [swift-networking](https://github.com/TelemTobi/swift-networking), for more details on networking implementation and usage.
* **Support:** Configuration files, localization resources, and other supporting assets.
* **Utility:** Contains constants, custom dependencies, extensions, modifiers, protocols, and UI component styles.
* **Views:** Reusable SwiftUI views that represent the application's user interface.
**Note:** This project is intended for educational purposes and demonstrates the usage of TCA. It might not be feature-complete and may require further development for a production-ready application.