Mobile iOS

iOS app for tracking all your media in one unified platform.

Features

• Native iOS app with modern SwiftUI;
• Track games, anime, movies, TV shows, books, and manga with progress system;
• Custom lists management;
• User profiles with favorites;
• Full i18n support;
• Feed with real-time updates;
• Push notifications for upcoming releases;
• Image gallery and screenshots;
• Content relationship viewer;
• Smooth animations and transitions;
• Responsive layouts for iPad;
• Native iOS design language;
• iCloud sync support;
• Widget support for Home Screen and Lock Screen.

Tech Stack

• Swift
• SwiftUI
• iOS 17+
• Combine
• URLSession
• Core Data
• UserDefaults
• CloudKit
• WidgetKit
• Kingfisher
• Swift Package Manager

Run Locally

Prerequisites

• macOS Ventura or later
• Xcode 15 or newer
• Apple Developer account (for running on physical device)
• iPhone/iPad with iOS 17+ or Simulator

Steps

1. Clone the project

git clone https://github.com/TrackGeek/mobile-ios.git

2. Open Xcode

• Launch Xcode
• Click on "Open a project or file"
• Navigate to the cloned repository folder
• Select TrackGeek.xcodeproj and click "Open"
• Wait for Xcode to index the project

3. Configure the project

• Select the TrackGeek project in the navigator
• Select the TrackGeek target
• Go to "Signing & Capabilities"
• Select your Team from the dropdown
• Update the Bundle Identifier if needed
• Configure API endpoints in the configuration files

4. Select a destination

• In the toolbar, click on the device/simulator selector
• Choose an iOS Simulator or your connected physical device

5. Build and run

• Click the "Run" button (play icon) or press Cmd+R
• Wait for the build to complete
• The app will launch automatically on your selected device/simulator

Build for Testing

To run unit tests:

xcodebuild test -scheme TrackGeek -destination 'platform=iOS Simulator,name=iPhone 15'

Or press Cmd+U in Xcode.

Build Archive

For App Store distribution:

1. Select "Any iOS Device" as the destination
2. Go to "Product" > "Archive"
3. Wait for the archive to complete
4. The Organizer window will open automatically
5. Select your archive and click "Distribute App"
6. Follow the wizard to submit to App Store Connect

Command Line Build

Build from terminal:

xcodebuild -scheme TrackGeek -configuration Release -archivePath ./build/TrackGeek.xcarchive archive

Contributing

Contributions are always welcome!

See CONTRIBUTING.md for ways to get started.

Please adhere to this project's code of conduct.