Skip to main content

​
Prerequisites

Before installing, ensure you have:
  • Flutter SDK (3.10.0 or later)
  • Dart SDK (included with Flutter)
  • Android Studio or Xcode (for emulators)
  • Git (for version control)

​
Step 1: Install Flutter

​
macOS

# Using Homebrew
brew install flutter

# Or download manually from https://flutter.dev

​
Windows

Download the Flutter SDK from flutter.dev and add to your PATH.

​
Linux

# Using snap
sudo snap install flutter --classic

# Or download manually
Verify installation: 
flutter doctor

​
Step 2: Clone Repository

git clone https://github.com/olympia-hq/zeus.git
cd zeus/app/flutter

​
Step 3: Install Dependencies

flutter pub get

​
Step 4: Run the App

​
Development Mode

# iOS Simulator
flutter run --flavor development

# Android Emulator
flutter run --flavor development

# Specific device
flutter run -d <device-id> --flavor development

​
Production Mode

flutter run --flavor production

​
Available Flavors

FlavorPurpose
developmentLocal development with debug info
stagingPre-production testing
productionProduction build

​
Common Issues

​
CocoaPods Error (macOS)

cd ios
pod install
cd ..
flutter run

​
Gradle Issues (Android)

cd android
./gradlew clean
cd ..
flutter pub get
flutter run

​
Missing Dependencies

flutter clean
flutter pub get
flutter run

​
IDE Setup

​
VS Code

Recommended extensions:
  • Dart
  • Flutter
  • BLoC
  • Flutter Riverpod Snippets

​
Android Studio

Install the Flutter and Dart plugins via the plugin marketplace.

​
Next Steps

Cache Overview

Learn about the local-first cache layer