SwiftPokedex

Table of Contents

• Overview
• Features
• Screenshots
• Tools and Techniques
• Running the Project
• Conclusion

Overview

This project is a Pokédex app featuring the first 151 Pokémon, developed using Swift and SwiftUI as part of the "Apple Foundation Program 2024" at the University of Palermo. The app provides a comprehensive display of Pokémon information, including their images, stats, and other details.

Features

• Comprehensive Pokémon Information: Displays detailed information about each of the first 151 Pokémon, including their base stats, types, and various sprites.
• Favorite Functionality: Users can mark their favorite Pokémon, and filter the list to show only favorites.
• Responsive UI: Uses SwiftUI to create a responsive and visually appealing user interface.

Screenshots

Tools and Techniques

Swift and SwiftUI

• Swift: The core programming language used for the development of the app.
• SwiftUI: Employed to design the user interface, allowing for a declarative syntax to create dynamic and responsive views.

Data Management

• ModelData: An observable class that manages the Pokémon data loaded from a JSON file. This data is shared across different views using the environment object pattern.
• JSON Parsing: Utilizes Swift's Codable protocol for parsing and loading Pokémon data from a JSON file, ensuring type safety and ease of use.

Design Patterns

• MVVM (Model-View-ViewModel): The app follows the MVVM design pattern to separate business logic from the UI, making the codebase more modular and testable.
• Environment Object: Leverages SwiftUI's environment object for state management, ensuring that data is easily accessible and updatable across various views.

UI Components

• Reusable Views: Custom views like PokemonRow, PokemonDetails, and ImagePreview are designed to be reusable and composable, promoting code reusability and readability.
• Conditional Views: Implements conditionally rendered views based on Pokémon attributes, such as displaying different sprites or decorations based on the Pokémon's type.

Running the Project

To run the project, you have two options:

Option 1: Using Xcode (macOS only)

1. Xcode: Install the latest version of Xcode to build and run the application.
2. macOS: Ensure your Mac is running a recent version of macOS that supports the latest Swift and SwiftUI features.

Option 2: Installing from IPA File using AltStore (works on macOS and Windows)

Alternatively, you can install the app using an IPA file. Follow these steps to install the IPA file using AltStore:

1. Go to the latest release on the releases page.
2. Download the IPA file to your computer.
3. Download and install AltStore on your computer from altstore.io.
4. Open AltStore and connect your iOS device to your computer.
5. Go to the “My Apps” tab in AltStore.
6. Click the "+" button and select the downloaded IPA file.
7. Enter your Apple ID and password if prompted.
8. The app will be installed on your device.
9. Navigate to "General" -> "Device Management" (or "Profiles & Device Management").
10. Find the profile for the app you just installed and trust it.
11. Now you can run the app from your device's home screen!

By following these steps, you can install the app using the IPA file with AltStore on your iOS device. This method is useful if you do not have a Mac or prefer not to build the app from Xcode directly.

Conclusion

Through this project, I have gained valuable experience in managing state with SwiftUI's environment objects, handling JSON data with Swift's Codable protocol, and designing responsive UI components. Additionally, I have deepened my understanding of the MVVM design pattern and its practical application in building modular and maintainable code. This project has not only enhanced my technical skills but also improved my ability to create well-structured, user-friendly applications. Overall, it has been an enriching learning experience, solidifying my proficiency in Swift and SwiftUI development.