Claudare

Claudare is exploring a family of local-first applications for personal data. The long-term goal is software that works offline across mobile and desktop, does not require a central application server, and can eventually synchronize encrypted data between devices controlled by the user.

Current status

Claudare is a development prototype, not a finished local-first product. apps/notes is the first Flutter application and exists to exercise the shared packages through a real consumer. Its note domain, storage layout, and user interface are examples, not the architectural center of the repository.

The current code supports local event-sourced application development. It does not implement network transport, device identity or enrollment, multi-device convergence, encryption, blob storage, or backup. The replicated-command staging primitives in cqrs are storage building blocks, not a working synchronization system.

Documentation

• App Development Guide explains how Flutter applications compose and consume the shared packages.
• Implementation Details describes package ownership and the implemented architecture.
• Security defines the current security posture and the claims the project cannot yet make.
• AGENTS.md contains repository workflow rules for AI agents.
• CONVENTIONS.md contains durable coding conventions for shared code.

Setup

Install FVM and make it available on PATH. From the workspace root, install the pinned SDK and resolve all workspace dependencies:

fvm install
fvm flutter pub get
fvm flutter doctor

Run and validate

Run the notes prototype:

cd apps/notes
fvm flutter run

Analyze the whole workspace and run all Dart and Flutter tests from the root:

fvm dart analyze
fvm dart run melos test

After workspace or dependency changes, also verify discovery:

fvm flutter pub get
fvm dart pub workspace list