Installation

This guide covers building AuraDeck from source. If you just want to run the app, grab a pre-built binary from the Download page instead — the source build is for contributors and platforms without an official bundle yet.

Prerequisites

On Linux you typically need webkit2gtk-4.1, libsoup-3.0, and a few build essentials. The Tauri docs page above lists the exact packages for each distribution.

Clone and build

git clone https://github.com/celray/auradeck.git
cd auradeck
npm install
npm run tauri build

The compiled binary ends up in src-tauri/target/release/auradeck. Tauri produces a single native executable with all web assets embedded — there is no dist/ directory to copy around.

For a faster development loop, use npm run tauri dev instead of build. This launches the app with hot-reload and source maps enabled.

Linux desktop integration

After building, run the install script to register AuraDeck with your desktop environment:

./linux/install-mime.sh           # install release binary
./linux/install-mime.sh --debug   # install debug binary

The script:

• Copies the binary to ~/.local/bin/.
• Installs an XDG .desktop entry so the app appears in your application menu.
• Registers the application/x-auradeck-slides MIME type for .adsl files.
• Installs an icon for the file type so .adsl archives show the AuraDeck logo in your file manager.

After running it, log out and back in (or run update-desktop-database ~/.local/share/applications and gtk-update-icon-cache ~/.local/share/icons) for everything to take effect.

macOS and Windows

Running npm run tauri build on macOS produces .dmg and .app bundles, and on Windows it produces .msi and .exe installers — both land under src-tauri/target/release/bundle/. Official pre-built bundles for end users are published to the Download page as they become available.

Try the quickstart →