Skip to main content
The Claude Board desktop app is a native application built with Tauri v2 and a Rust backend. On first launch, a guided setup wizard walks you through system configuration and creates your first project.

​
Setup Wizard

The setup wizard consists of 6 steps with system validation, language selection, and project configuration:

Welcome

Splash screen with animated logo and loading indicator while the Rust backend initializes.

Language Selection

Choose your preferred language (English or Turkish). This sets the UI language for the entire application.

System Check

Automated validation of your environment:
  • Claude CLI — verifies claude is installed and accessible on PATH
  • Node.js — checks for Node.js 18+ compatibility
  • Git — confirms git is available for branch automation
  • Port availability — validates the MCP server port (default 4000)

Data Directory

Choose where Claude Board stores its SQLite database, uploads, and configuration. Defaults to the OS-specific application data path.

MCP Server Port

Configure the port for the built-in MCP HTTP server used by Claude runner integration. The wizard verifies the port is available before proceeding.

First Project

Create your first project with a name and working directory. This project will appear on your board immediately after setup completes.

​
Splash Screen

While the Rust backend initializes, a splash screen displays the Claude Board logo with ambient animations and a loading indicator. The main window opens once the backend is ready.

​
Single Instance Lock

Only one instance of Claude Board can run at a time. If you try to open a second instance:
  • The existing window is brought to the front
  • The second instance exits silently
This prevents database locking issues from multiple processes accessing the same data directory.

​
System Tray

The desktop app minimizes to the system tray. Right-click the tray icon for options:
  • Show — bring the window to front
  • Quit — stop the backend and exit

​
Changing Settings After Setup

To reconfigure the data directory or MCP server port after initial setup:
  1. Open the app’s settings from the menu
  2. Update the values
  3. Restart the app for changes to take effect
Changing the data directory does not migrate existing data. Copy the database and uploads folder manually if needed.