Skip to content

Latest commit

 

History

History
152 lines (125 loc) · 6.89 KB

README.md

File metadata and controls

152 lines (125 loc) · 6.89 KB

Logo

SwiftyMarvel 🦸‍♂️

Platform License: MIT Star on Github codecov Build Status
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

Splash Home Search while typing Favorites Character Profile

Quick start

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:

  1. Go to the Marvel Developer Portal and create an account.

  2. Once you have an account, go to the Get a Key page and get your public and private keys.

  3. Create a file called .env in the root directory of the project and add the following lines to it:

    MarvelPublicKey=your_public_key
    MarvelPrivateKey=your_private_key
  4. Run the following command to generate the ArkanaKeys local package that will be used to securely fetch your keys in runtime:

    bin/arkana
  5. Now you can open the project in Xcode and run it.

Project Structure

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.

Folder Structure

📦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.

Tools & Frameworks Used

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

Development Environment

  • Xcode 14.3.1
  • Swift 5.8.1
  • iOS Deployment Target 16.2

CI Pipeline

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.

License

This project is licensed under the MIT License - see the LICENSE file for details