When? (iOS)

An iOS application for showing public transit departures from a selected stop/station in Berlin.

Install

📲 Install from the App Store

Architecture

• iOS App: Swift, SwiftData, SwiftUI
• Firebase Firestore for storing live activities while they're active
• Firebase Cloud functions (bez4pieci/When-App-API) for updating the live activities via push notifications
• Public transport API
  • alexander-albers/tripkit for iOS
  • public-transport/hafas-client for the Node.js cloud function

Build From Source

1. Check out the code and cd to the project root
2. Set up Firebase:
   1. Create a new project
   2. Add an iOS app (instructions)
      • Use com.bez4pieci.When as bundle id
      • Leave optional fields blank
      • 👉 Download GoogleService-Info.plist and put it in the project root
   3. Create a new Firestore database. You don't need to do anything beyond just creating it.
3. Set up MapBox
   1. Create an account
   2. Make a copy of MapBox.plist-example and name it MapBox.plist
   3. Paste your MapBox token as the string value for the key MBXAccessToken
4. Open the project in XCode
5. Build with XCode

Develop

VSCode / Cursor Setup

1. Make sure to open the project in XCoce at least once. This will create the necessary XCode project configuration on your computer.

2. Install xcode-build-server:

   brew install xcode-build-server

3. Let SourceKit-LSP know about XCode configuration:

   cd <project root>
   xcode-build-server config -project *.xcodeproj

   This command creates a buildServer.json file in your project root that allows SourceKit-LSP to understand your Xcode project configuration, including:

   • Build settings
   • Target configurations
   • Dependencies
   • Module imports

Build Using Command Line

# Build
xcodebuild -project Departures.xcodeproj -scheme Departures -destination 'platform=iOS Simulator,name=iPhone 16'

# Open in the simulator
xcrun simctl launch booted com.bez4pieci.When

License

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