> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeus.ttr.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Set up Flutter development environment for Zeus

## 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

```bash theme={null}
# Using Homebrew
brew install flutter

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

### Windows

Download the Flutter SDK from [flutter.dev](https://flutter.dev) and add to your PATH.

### Linux

```bash theme={null}
# Using snap
sudo snap install flutter --classic

# Or download manually
```

Verify installation:

```bash theme={null}
flutter doctor
```

## Step 2: Clone Repository

```bash theme={null}
git clone https://github.com/olympia-hq/zeus.git
cd zeus/app/flutter
```

## Step 3: Install Dependencies

```bash theme={null}
flutter pub get
```

## Step 4: Run the App

### Development Mode

```bash theme={null}
# iOS Simulator
flutter run --flavor development

# Android Emulator
flutter run --flavor development

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

### Production Mode

```bash theme={null}
flutter run --flavor production
```

## Available Flavors

| Flavor        | Purpose                           |
| ------------- | --------------------------------- |
| `development` | Local development with debug info |
| `staging`     | Pre-production testing            |
| `production`  | Production build                  |

## Common Issues

### CocoaPods Error (macOS)

```bash theme={null}
cd ios
pod install
cd ..
flutter run
```

### Gradle Issues (Android)

```bash theme={null}
cd android
./gradlew clean
cd ..
flutter pub get
flutter run
```

### Missing Dependencies

```bash theme={null}
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

<Card title="Cache Overview" icon="database" href="/flutter/cache/overview">
  Learn about the local-first cache layer
</Card>