SwiftyMarvel is a SwiftUI app that uses the Marvel API to display a list of Marvel characters and their details. You can browse through hundreds of heroes and villains from the Marvel universe, see their comics, and learn more about their powers and abilities.
This app is created as a personal project to showcase my skills and passion for iOS development. This app demonstrates how to implement Clean Architecture and some of best practices for iOS app development using SwiftUI, CoreData, Combine, MVVM, Dependency Injection, Unit Testing, Code Coverage, and more.
Report bug
·
Request feature
- Screenshots
- Quick start
- Project Structure
- Tools & Frameworks Used
- Development Environment
- CI Pipeline
- License
As this project uses the Marvel API, you need to get your own API keys to run the project. You can get them by following these steps:
-
Go to the Marvel Developer Portal and create an account.
-
Once you have an account, go to the Get a Key page and get your public and private keys.
-
Create a file called
.envin the root directory of the project and add the following lines to it:MarvelPublicKey=your_public_key MarvelPrivateKey=your_private_key
-
Install the Arkana gem by running the following command in your terminal:
bundle install
You must have ruby and bundler installed on your machine to run the above command. If you don't have them, you can install them by following the instructions here for Ruby and here for Bundler.
-
Run the following command to generate the ArkanaKeys local package that will be used to securely fetch your keys in runtime:
bin/arkana
-
After generating the ArkanaKeys package, you will need to add it to the project. To do this:
- open the
SwiftyMarvel.xcodeprojfile in Xcode, then go toFile > Add Package Dependencies > Add Local...and select theArkanaKeys/ArkanaKeysfolder that was generated in the root directory of the project. - Make sure to add
SwiftyMarvelto the target.
- open the
-
Now you can run the project in Xcode.
This project uses Clean Architecture and is separated into four main layers:
- Data: Contains the repositories implementations responsible for abstracting the data source used. In this case, the data sources are a REST API and a Core Data database.
- Domain: Holds the business logic layer, which contains the use cases responsible for handling the business logic of the application and the abstract repositories. The use cases are the entry point to the domain layer.
- Presentation: Contains the UI responsible for presenting the data to the user and handling user interactions. It also contains the ViewModels, which are responsible for preparing the data to be presented and for handling the interactions between the view and the use cases.
- Core: Contains the common code between the other layers, like the extensions and the dependency injection code.
📦SwiftyMarvel
┣ 📂Core
┃ ┣ 📂DI
┃ ┗ 📂Extensions
┣ 📂Data
┃ ┣ 📂Constants
┃ ┣ 📂DataSource
┃ ┣ 📂Model
┃ ┣ 📂Mappers
┃ ┣ 📂Networking
┃ ┗ 📂Repository
┣ 📂Domain
┃ ┣ 📂Entity
┃ ┣ 📂Errors
┃ ┣ 📂Repository
┃ ┗ 📂UseCase
┣ 📂Presentation
┃ ┣ 📂Core
┃ ┣ 📂ReusableViews
┃ ┣ 📂Screens
┃ ┃ ┣ 📂Home
┃ ┃ ┃ ┣ 📂ViewModels
┃ ┃ ┃ ┗ 📂Views
┗ 📜SwiftyMarvelApp.swift => The app entry point.| Tool | Used for |
|---|---|
| MVVM | Architectural design pattern for separating the logic form the views |
| Core Data | Storing favorite characters |
| Swinject | Dependency Injection |
| Arkana | Securely storing secrets and keys |
| Nuke | Image Loading & Caching |
| SwiftLint | Code Linting |
| Mockingbird | Generating mock, stub, and verify objects in Swift unit tests |
| Swift Testing Framework | Unit Testing Framework |
- Xcode 26.0
- Swift 6.2
- iOS Deployment Target 26.0
This project uses GitHub Actions and Codecov to automate the building, testing, and code coverage analysis of the project. The CI pipeline runs whenever a new commit or pull request is made to the main branch.
This project is licensed under the MIT License - see the LICENSE file for details
