Nest Engineering Docs
Raven Desktop

Overview

macOS Flutter side-panel app with OCR automations

Raven Desktop is a macOS Flutter companion app that lives in a side-panel window. It uses OS-native OCR to read screen content and automate workflows for the Raven product. The app communicates with the Raven backend over ConnectRPC.

App profile

FieldValue
Codeapps/raven/
StackFlutter (macOS)
Primary ownerAkansh Divker
Secondary ownerNone
Backendservices/raven/ (ConnectRPC/HTTP/2)

Responsibilities

  • Provide the desktop UI and side-panel experience.
  • Perform OCR-based screen reading and workflow automation.
  • Communicate with Raven backend for search and auth.

Tech stack

  • Flutter desktop (Dart 3.10) on macOS.
  • State management with Riverpod.
  • Routing with go_router.
  • UI: shadcn_ui, lucide_icons_flutter, font_awesome_flutter, mesh_gradient.
  • Networking: ConnectRPC over HTTP/2 with protobuf and Firebase Auth tokens.
  • Telemetry: Sentry + Statsig.

Code entrypoints

  • lib/main.dart: app bootstrap, window configuration, Sentry/Statsig/Firebase init.
  • lib/app/app.dart: ShadApp shell, theming, router wiring.
  • lib/app/router.dart: go_router routes and auth/startup redirects.

Last updated on