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

# Introduction

> Flutter mobile application for Zeus Finance

## Overview

The Zeus Flutter app provides a beautiful, responsive mobile interface for expense tracking. Built with modern Flutter patterns and a local-first architecture.

## Features

<CardGroup cols={2}>
  <Card title="Offline-First" icon="wifi-slash">
    Full functionality without network connection
  </Card>

  <Card title="Cross-Platform" icon="mobile">
    Single codebase for iOS and Android
  </Card>

  <Card title="State Management" icon="database">
    BLoC pattern for predictable state
  </Card>

  <Card title="Local Cache" icon="hard-drive">
    SQLite for instant data access
  </Card>
</CardGroup>

## Tech Stack

| Component  | Technology     | Purpose              |
| ---------- | -------------- | -------------------- |
| Framework  | Flutter 3.10+  | UI framework         |
| State      | BLoC + Cubit   | State management     |
| Cache      | sqflite        | SQLite database      |
| Networking | http/dio       | API communication    |
| DI         | Provider/GetIt | Dependency injection |

## Project Structure

```
lib/
├── cache/              # Local-first cache layer
│   ├── models/         # Data models
│   ├── repositories/   # CRUD operations
│   ├── providers/      # Storage implementations
│   └── services/       # Sync logic
├── app/                # App configuration
│   ├── view/           # Root app widget
│   └── app.dart        # App exports
├── l10n/               # Localization
│   ├── arb/            # Translation files
│   └── gen/            # Generated code
├── bootstrap.dart      # App initialization
└── main.dart           # Entry point
```

## Key Principles

### Local-First

All data operations happen locally first:

```dart theme={null}
// Create transaction locally
final transaction = await cache.createTransaction(
  walletId: wallet.id,
  amount: 25.50,
  type: 'expense',
);

// Automatically queued for background sync
```

## Next Steps

<CardGroup cols={2}>
  <Card title="Installation" icon="download" href="/flutter/installation">
    Set up your development environment
  </Card>

  <Card title="Cache Layer" icon="database" href="/flutter/cache/overview">
    Learn about the cache layer
  </Card>
</CardGroup>