Installation

Diagrammer can be installed as a desktop application or run directly in your browser.

Desktop Application (Recommended)

The desktop version provides the best performance and full feature access including native file system integration.

Windows

1. Download the latest .msi or .exe installer from the releases page
2. Run the installer and follow the prompts
3. Launch Diagrammer from the Start menu

Linux

AppImage (Universal)

chmod +x Diagrammer-*.AppImage
./Diagrammer-*.AppImage

Debian/Ubuntu (.deb)

sudo dpkg -i diagrammer_*.deb

macOS

There are no pre-built macOS binaries yet. You can build from source — it only takes a few minutes. See the instructions below.

Building from Source

Building from source is straightforward on all platforms. macOS users — this is your primary installation path.

Prerequisites

You'll need three tools installed before building:

macOS

1. Install Xcode Command Line Tools (provides C compiler and system headers)

   xcode-select --install

2. Install Bun (JavaScript runtime and package manager)

   curl -fsSL https://bun.sh/install | bash

   Close and reopen your terminal, then verify with bun --version.

3. Install Rust (for the Tauri desktop backend)

   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

   Choose the default installation when prompted. Close and reopen your terminal, then verify with rustc --version.

Tip: If you use Homebrew, you can also install Bun with brew install oven-sh/bun/bun.

Windows

1. Install Bun — download from bun.sh or run:

   powershell -c "irm bun.sh/install.ps1 | iex"

2. Install Rust — download from rustup.rs and run the installer.

3. Install Visual Studio Build Tools — required for Rust on Windows. Download from Visual Studio and install the "Desktop development with C++" workload.

Linux

1. Install Bun

   curl -fsSL https://bun.sh/install | bash

2. Install Rust

   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

3. Install system dependencies (Debian/Ubuntu)

   sudo apt-get update
   sudo apt-get install -y libwebkit2gtk-4.1-dev libappindicator3-dev \
     librsvg2-dev patchelf

   For other distros, see the Tauri prerequisites.

Build the App

Once prerequisites are installed, the build process is the same on all platforms:

# Clone the repository
git clone https://github.com/QR-Madness/diagrammer.git
cd diagrammer

# Install JavaScript dependencies
bun install

# Build the desktop application
bun run tauri:build

The build takes a few minutes on first run (Rust compiles all dependencies). The finished installer will be in:

Platform	Output location
macOS	src-tauri/target/release/bundle/dmg/ and macos/
Windows	src-tauri/target/release/bundle/nsis/ and msi/
Linux	src-tauri/target/release/bundle/appimage/ and deb/

INFO

On macOS, the built .app is unsigned. On first launch, right-click the app and select Open, then click Open again in the dialog to bypass Gatekeeper.

Running in Development Mode

If you want to run Diagrammer without creating an installer:

# Web version only (opens in browser)
bun run dev

# Desktop app with hot-reload
bun run tauri:dev

System Requirements

Component	Minimum	Recommended
OS	Windows 10, macOS 10.15, Ubuntu 20.04	Latest versions
RAM	4 GB	8 GB+
Display	1280×720	1920×1080+
Storage	200 MB	500 MB+

Next Steps

Learn how to create your first diagram with the Quick Start Guide.