Local development

Prerequisites

• Flutter SDK (Dart 3.10, see apps/raven/pubspec.yaml).
• macOS desktop support enabled (flutter config --enable-macos-desktop).
• Xcode for macOS builds and signing.
• Raven backend running (services/raven/).
• A local .env file (copy from .env.example).

Run locally

cd apps/raven
cp .env.example .env
dart run build_runner build --delete-conflicting-outputs
flutter pub get
flutter run -d macos

Backend connectivity

Set RAVEN_SERVICE_URL in .env to the ConnectRPC base URL. The default is http://localhost:8080, which assumes services/raven is running locally.

Debug tools

• /debug route is available in debug builds only.
• RavenLogger prints provider changes when RavenProviderObserver is enabled.

Permissions

Grant Screen Recording and Accessibility permissions when prompted so OCR and automation features can function.

Tests

• Unit tests: flutter test
• OCR service tests live under apps/raven/test/features/ocr/.