Canopy

Canopy is a local-first desktop application foundation built with React, TypeScript, and Tauri 2.

Prerequisites

• Node.js 24.x
• pnpm 11.21.0
• Rust 1.97.1 (selected automatically by rust-toolchain.toml)
• The Tauri Linux system dependencies for your distribution

Setup and development

Install the locked JavaScript dependencies:

pnpm install --frozen-lockfile

Start the frontend development server on http://localhost:1420:

pnpm dev

Validation

Run the complete frontend quality gate:

pnpm check

Inspect the native toolchain and compile the debug desktop application without producing a bundle:

pnpm tauri info
pnpm tauri build --debug --no-bundle

Run the Rust checks independently:

cargo fmt --manifest-path src-tauri/Cargo.toml --check
cargo clippy --manifest-path src-tauri/Cargo.toml --all-targets --all-features -- -D warnings
cargo test --manifest-path src-tauri/Cargo.toml --all-features

Automated desktop builds

The Build desktop clients GitHub Actions workflow builds installable clients for Linux x64, Windows x64, macOS Apple Silicon, and macOS Intel. It runs for pull requests and pushes to main, version tags matching v*, and manual dispatches.

Download the unsigned AppImage, deb, exe, and dmg bundles from the workflow run's Artifacts section. Production distribution still requires platform-specific code signing and macOS notarization.