Skip to main content

​
Quick start

This guide will help you set up and run Thrust on your Mac.

​
Requirements

  • macOS 14.0+
  • Xcode 16.0+
  • Swift 6.2+
  • iOS Simulator or physical device with iOS 17+

​
Installation

​
1. Clone the repository

git clone https://github.com/Andrei-Kondrykau/thrust.git
cd thrust

​
2. Open the project

open Thrust.xcodeproj
Or use the quick script: 
./Scripts/OPEN_XCODE_NOW.sh

​
3. Install dependencies

Xcode will automatically download Swift Package Manager dependencies when you first open the project. Dependencies:
  • ConfettiSwiftUI (2.0.0)
  • LeapSDK (0.9.0)

​
4. Configure secrets (optional)

To work with external APIs, create a Thrust/Config/Secrets.plist file: 
cp Thrust/Config/Secrets.plist.template Thrust/Config/Secrets.plist
Edit Secrets.plist and add your API keys:
  • GoCardless Secret ID and Secret Key (for bank synchronization)
  • CoinGecko API Key (for crypto prices)
  • Yahoo Finance API Key (for stocks)
The app works without API keys in Ghost Mode (manual data entry).

​
5. Select scheme and run

  1. In Xcode, select the Thrust scheme
  2. Choose a simulator (e.g., iPhone 16)
  3. Press Cmd+R to run

​
First launch

On first launch, you’ll see the onboarding flow:
  1. Welcome - Welcome screen
  2. Account setup - Sign in with Apple ID (can be skipped)
  3. Profile setup - Name and currency
  4. Privacy mode - Choose your mode:
    • Connected mode - Sync with banks
    • Ghost mode - Manual entry (100% privacy)
  5. Notifications - Permission for notifications
Use the Quick Start button on the Welcome screen for instant access to the app in Ghost Mode.

​
Building from command line

​
Build the project

xcodebuild -scheme Thrust \
  -destination 'platform=iOS Simulator,name=iPhone 16' \
  build

​
Run tests

xcodebuild test -scheme Thrust \
  -destination 'platform=iOS Simulator,name=iPhone 16'

​
Code quality check

./Scripts/quality-check-fintech.sh

​
Next steps