Monorepo for Calimero desktop applications built with Tauri.

Download Calimero Desktop - Available for macOS, Windows, and Linux

.
├── apps/
│   ├── desktop/          # Tauri desktop application
│   └── download-site/    # Download landing page
├── packages/
│   └── mero-react/       # React bindings and components
└── pnpm-workspace.yaml   # Workspace configuration

Note: mero-js SDK package has been moved to the repository root as an independent package.

• Node.js >= 18.0.0
• pnpm >= 8.0.0
• Rust (for Tauri)

# Install dependencies
pnpm install

# Build workspace packages
pnpm build:mero-react

# Start development server
pnpm dev:desktop

# Start with DevTools forced ON
pnpm dev:desktop:devtools

# Start with DevTools forced OFF
pnpm dev:desktop:no-devtools

# Build for production
pnpm build:desktop

# Run Tauri commands
pnpm tauri:desktop [command]

DevTools can be controlled via environment variables:

• Default (pnpm dev:desktop): DevTools opens automatically in debug builds
• Force ON (pnpm dev:desktop:devtools): DevTools always opens
• Force OFF (pnpm dev:desktop:no-devtools): DevTools never opens

Important: Release builds (.dmg, .exe, etc.) never have DevTools enabled, regardless of environment variables. This is enforced at compile time for security.

# Start download site dev server
cd apps/download-site
pnpm dev

# Build for production
pnpm build

# Build mero-react package
pnpm build:mero-react

# Note: mero-js is installed from npm registry (@calimero-network/mero-js)
# and does not need to be built locally

The desktop app automatically checks for updates on startup and periodically. When a new version is available, you'll see a notification with options to update immediately or later.

Releases are tag-based. Pushing a vX.Y.Z tag triggers the release workflow, which builds desktop bundles for macOS, Windows, and Linux in parallel and creates a GitHub Release.

See RELEASES.md for detailed release process documentation.

• Releases - Release process and CI/CD documentation