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

# Project Structure

> Understanding the Flutter project organization

## Directory Layout

```
app/flutter/
├── android/           # Android-specific code
├── ios/               # iOS-specific code
├── lib/               # Main Dart code
├── test/              # Unit and widget tests
├── assets/            # Images, fonts, etc.
├── pubspec.yaml       # Dependencies
└── analysis_options.yaml  # Lint rules
```

## The `lib/` Directory

```
lib/
├── cache/                    # Cache layer
│   ├── cache.dart           # Barrel exports
│   ├── cache_manager.dart   # Main cache API
│   ├── database/            # SQLite setup
│   ├── models/              # Data models
│   ├── providers/           # Storage providers
│   ├── repositories/        # CRUD operations
│   └── services/            # Sync service
├── app/
│   ├── app.dart            # App exports
│   └── view/
│       └── app.dart        # Root app widget
├── l10n/                   # Internationalization
├── bootstrap.dart          # App initialization
└── main_*.dart             # Entry points
```

## Cache Layer

The most important directory:

| Path                  | Purpose                                 |
| --------------------- | --------------------------------------- |
| `cache/models/`       | Data models (Wallet, Transaction, etc.) |
| `cache/repositories/` | Database operations                     |
| `cache/services/`     | Sync logic                              |
| `cache_manager.dart`  | Main API for app code                   |

## Entry Points

* `main_development.dart` - Development mode
* `main_staging.dart` - Staging mode
* `main_production.dart` - Production mode

All call `bootstrap.dart` for initialization.

## Key Files

### bootstrap.dart

App initialization:

```dart theme={null}
Future<void> bootstrap(...) async {
  // Initialize cache
  final cache = await CacheManager.initialize();
  
  // Configure sync
  cache.configureSync(apiClient);
  
  // Auto-sync on startup
  await cache.initializeSync();
  
  runApp(...);
}
```

### pubspec.yaml

Dependencies include:

```yaml theme={null}
dependencies:
  flutter:
    sdk: flutter
  sqflite: ^2.3.0          # SQLite
  path_provider: ^2.1.1    # File paths
  uuid: ^4.2.1             # UUID generation
  bloc: ^9.2.0             # State management
  flutter_bloc: ^9.1.1
```

## Best Practices

1. **Feature-based folders** - Group by feature, not type
2. **Barrel exports** - Use `index.dart` or `*.dart` for clean imports
3. **Separation of concerns** - UI, business logic, data layers separate
4. **Dependency injection** - Inject repositories into blocs/cubits