Dauphin

Overview

Dauphin is an iOS app with a companion Widget extension. The codebase is organized by feature and backed by XCTest coverage.

Requirements

• Xcode 15.4 or newer
• iOS Simulator (iPhone 15 or newer recommended)
• Swift 5.9+

Getting Started

1. Clone the repo.
2. Open dauphin.xcodeproj in Xcode.
3. Select the dauphin scheme and build/run.

Common Commands

xcodebuild -project dauphin.xcodeproj -scheme "dauphin" -configuration Debug -destination 'platform=iOS Simulator,name=iPhone 17,OS=26.0' clean build

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

swift-format lint --configuration .swift-format --recursive .

xcrun simctl install booted build/Debug-iphonesimulator/dauphin.app

Project Structure

• dauphin/: iOS app sources (views, view models, utilities).
• CoursesWidget/: Widget extension.
• Tests/: Unit and snapshot tests.
• Root configs: api.plist, StdID (sample values only).

Contributing

• Keep SwiftLint warnings at zero.
• Add or update tests for behavior changes.
• Run lint and tests before opening a PR.