Packages Overview

Shared libraries used across services, jobs, and apps. Packages are grouped by language and are intended to be imported rather than run as standalone services.

Layout

• packages/python/: Python 3.13 libraries in the uv workspace.
• packages/flutter/: Flutter/Dart packages consumed by desktop clients.
• packages/ts/: Reserved for TypeScript packages (currently empty).

Workspace wiring

Python (uv)

• Install or update all Python packages from the repo root with uv sync --all-packages.
• Each package owns its dependencies in packages/python/*/pyproject.toml.

Flutter/Dart

• Flutter packages are consumed via path dependencies (see apps/raven/pubspec.yaml).
• Run flutter pub get in apps/raven/ after updating a package.

Protobuf generation

• buf generate refreshes packages/python/nest_protos and the Dart stubs in apps/raven/lib/gen.

Packages

Python

• common: Shared Spanner, secrets, logging, and task helpers.
• nest-protos: Generated protobuf + ConnectRPC stubs (Python 3.13).

Flutter/Dart

• flutter-acrylic: Desktop window effects plugin used by Raven.
• screenshot-desktop: Pure Dart desktop screenshot library.