Marvel App

Swift Platforms

This project based on the Marvel API, some of its features are:

  • List characters
  • Pagination
  • Detail of character (image, information…)
    • Comics where appear
    • Series where appear
  • Search filter by name of specific character
  • Empty pagination control and non-existing results
  • Multilanguage app
  • DarkMode support
  • Local data caching when entering a character detail

This app is a simple demo to show the functionality of the API with iOS.


To use Marvel API you should create an account and generate an API key and configure the .xcconfig files depending on the development environment in which we want to launch our application. Example:Realease.xcconfig, changing your created API key.


We can launch our app in 3 different development environments Release, Development and Debug, selecting the following targets:

  • MarvelWorldWide (Release)
  • MarvelWorldWideDevelop (Development)
  • MarvelWorldWideDebug (Debug)

Deployment info: iOS 15.2


To run the unit tests of the app, we must select the MarvelWorldWideTests target and press Command+U, then the corresponding unit tests will be launched.

Third Party Libraries

I have used the following libraries to develop the project:

  1. Animations with Lottie
  2. Asynchronous download of images with Kingfisher
  3. Key encryption and network parameters CryptoSwift

I have used Swift Package Manager for library management

Database Local

Simulation of saving in a local database with UserDefaults since I have tried to use ObjectBox and I have not been able to integrate it with SwiftPackageManager, but it is correctly implemented to be able to refactor the persistence layer with any local database tool.

Architecture – Functionality – Workflow

  1. I have used the MVVM architecture pattern with some VIPER principles
  2. Dependency Injection
  3. Native Network layer via URLSession
  4. Facade pattern
  5. Protocol-oriented programming
  6. Coordinator Pattern.
  7. Factory Pattern
  8. Communication between layers through closures and Result and manage errors.
  9. Using GitFlow metodology and Pull request to simulate a real working environment.
  10. Singleton Pattern


In the images below can see some screenshots of the application in Light and Dark mode.





 let enjoy = "I hope you like it ❤️"

Copyright © 2022 Jorge Martín Reyero. All rights reserved.


View Github