Desktop

Desktop Setup (ɳTasks)

Setup guide for the Tauri 2 desktop app (apps/desktop/).

Status: Shipped. The Tauri 2 shell wraps the web SPA and builds for macOS, Windows, and Linux.

Overview

The desktop app is a Tauri 2 wrapper around the Vite web SPA (web/ntask/ in the web monorepo — see Web-SPA). It shares the same React 19 codebase, bundled into a native shell for macOS, Windows, and Linux.

Prerequisites

Tool	Version	Notes
Node	20+	JS/TS runtime
pnpm	10+	Package manager
Rust (rustup)	Latest stable	`curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs
XCode CLI	Latest	macOS builds (xcode-select --install)
MSVC	Latest	Windows builds (Visual Studio Build Tools)

Install Tauri CLI:

cargo install tauri-cli

Environment Config

cd apps/desktop
cp .env.example .env.local

Desktop uses the same env vars as web/ntask/ (VITE_* vars) — Tauri embeds the built Vite frontend.

Run (Development)

Start the backend first:

cd backend && make up

Then start Tauri dev mode:

cd apps/desktop
pnpm tauri dev   # Starts Vite frontend + Tauri native shell

Build

cd apps/desktop
pnpm tauri build   # Produces platform installer

Output:

• macOS: src-tauri/target/release/bundle/dmg/*.dmg
• Windows: src-tauri/target/release/bundle/msi/*.msi
• Linux: src-tauri/target/release/bundle/deb/*.deb

Related

• Monorepo-Setup: workspace layout
• Web-SPA: the Vite frontend embedded in this app (lives in the web monorepo)
• Backend-Setup: backend setup
• Deployment: release guide