> ## Documentation Index
> Fetch the complete documentation index at: https://docs.claboard.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Desktop Setup

> 6-step setup wizard, system validation, and first-project configuration

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:

<Steps>
  <Step title="Welcome" icon="hand-wave">
    Splash screen with animated logo and loading indicator while the Rust backend initializes.
  </Step>

  <Step title="Language Selection" icon="globe">
    Choose your preferred language (English or Turkish). This sets the UI language for the entire application.
  </Step>

  <Step title="System Check" icon="check-circle">
    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)
  </Step>

  <Step title="Data Directory" icon="folder">
    Choose where Claude Board stores its SQLite database, uploads, and configuration. Defaults to the OS-specific application data path.
  </Step>

  <Step title="MCP Server Port" icon="plug">
    Configure the port for the built-in MCP HTTP server used by Claude runner integration. The wizard verifies the port is available before proceeding.
  </Step>

  <Step title="First Project" icon="rocket">
    Create your first project with a name and working directory. This project will appear on your board immediately after setup completes.
  </Step>
</Steps>

## 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

<Info>This prevents database locking issues from multiple processes accessing the same data directory.</Info>

## 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

<Note>Changing the data directory does not migrate existing data. Copy the database and uploads folder manually if needed.</Note>