rad roots | app

collaborative agriculture network

Overview

Radroots app is the open-source GPUI desktop application for local-first farm commerce.

The app focuses on farmer inventory, order, and Pack day workflows plus personal buyer discovery, cart, and order surfaces. It uses local SQLite persistence and synchronizes through the Radroots Nostr protocol stack when runtime configuration is available.

When this repository is mounted inside the Radroots Platform monorepo, the platform canonical specs govern product scope. This README is limited to repository orientation, source layout, and command surface.

Repository Structure

• crates/desktop/: radroots_app GPUI desktop launcher
• crates/runtime/: application runtime contracts and source guards
• crates/i18n/: message catalogs and typed copy helpers
• crates/types/: durable app-local identifiers, records, statuses, and DTOs
• crates/view/: screen projections, workflow drafts, summaries, and rows
• crates/signer/: remote signing integration boundary
• crates/store/: local database migrations and persistence
• crates/state/: app state and workflow projections
• crates/sync/: synchronization contracts and state
• crates/ui/: GPUI interface implementation
• platforms/macos/: macOS host wrapper, entitlements, and scripts
• scripts/: repository validation and run entrypoints

This repository currently ships the GPUI desktop launcher and a macOS host wrapper. It does not publish web, iOS, or Android app targets.

Commands

Run commands from the repository root.

cargo metadata --format-version 1 --no-deps
cargo check -p radroots_app
cargo test
./scripts/check.sh

To run the app, provide a default relay URL:

RADROOTS_APP_DEFAULT_NOSTR_RELAY_URL=wss://relay.example ./scripts/run.sh

License

This code is released under a copyleft open-source license. We welcome all contributions. If you would like to provide feedback, suggest features, or contribute code, please refer to our CONTRIBUTING.md document.