Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

macOS Development

This guide covers local desktop development on macOS. Tauri uses the system WebKit/WKWebView stack on macOS, so no WebKitGTK packages are needed.

Prerequisites

  • macOS on Apple Silicon or Intel.

  • Xcode Command Line Tools:

    xcode-select --install

  • Node.js 24.x, matching the repository .nvmrc.

  • Rust from rustup; the repository pins Rust 1.96.0 in rust-toolchain.toml.

  • npm for reproducible dependency installs.

  • Optional: Docker Desktop or Podman for sample database containers.

Setup

From the irodori-table repository root:

rustup toolchain install
task setup
task doctor

The root is not an npm workspace. Prefer the root Makefile shortcuts, or run desktop scripts with npm --prefix apps/desktop ....

Run the desktop app

task desktop-dev

task desktop-dev starts Vite on http://localhost:1420 and launches the Tauri desktop shell. If you start a debug binary directly without Vite running, the window will be blank or show a connection-refused message.

Common checks

task desktop-format-check
task desktop-lint
task desktop-test
task desktop-build-verified

Use cargo test --workspace for Rust backend changes.

Sample databases

Sample database containers live in the sibling irodori-samples repository:

git clone https://github.com/irodori-table/irodori-samples ../irodori-samples
task db-up DB=postgres
task db-verify DB=postgres

Use the container engine that works best on your machine. The development doctor detects Docker or Podman when either is available.