Trackeep/desktop/README.md

Trackeep Desktop (Tauri v2)

Trackeep Desktop is a native shell for Linux, Windows, and macOS.

It opens your own self-hosted Trackeep instance URL in a native Tauri WebView, so all application behavior stays identical to your web deployment:

• authentication/session management
• file upload/download
• realtime connections and API calls
• server-side update logic from your Trackeep backend

Because the desktop main window loads your hosted instance directly, the UI and behavior are the same as the web app.

Run in development

cd desktop
npm install
npm run tauri:dev

Build desktop bundles

cd desktop
npm install
npm run tauri:build

Generated bundles appear under desktop/src-tauri/target/release/bundle/.

Instance configuration flow

On first launch, the app shows a setup screen where the user enters the Trackeep instance URL, for example:

• https://trackeep.example.com
• http://192.168.1.50:80

The URL is stored in Tauri's app config directory as instance.json (platform-specific location).

Users can change instance from the desktop app menu:

• Trackeep -> Desktop Integrations...

Native desktop features

Desktop Integrations includes optional native capabilities:

• API key/token for desktop uploads
• token permission validation (files:read, files:write, files:share)
• local sync folder selection
• direct native file picker upload (Upload Files...)
• quick share flow (Quick Share Files...) that uploads, creates share links, and copies links to clipboard
• folder-to-instance sync (Sync Folder Now)
• open sync folder in OS file manager

For cloud storage workflows, point the sync folder to a cloud-synced directory (OneDrive, Dropbox, Google Drive desktop client, iCloud Drive).

Create an API key in Trackeep Settings -> Browser Extension with:

• files:read
• files:write
• files:share (recommended for quick-share links)

Cross-platform prerequisites

Tauri requires native toolchains per platform. Follow official setup docs:

• https://v2.tauri.app/start/prerequisites/