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

# Installation

> Download Claude Board or build from source

## Prerequisites

Before installing Claude Board, make sure you have:

<Steps>
  <Step title="Claude Code CLI" icon="terminal">
    Install and authenticate the [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code). Run `claude --version` to verify.
  </Step>

  <Step title="Git" icon="code-branch">
    Git must be installed for branch automation and commit tracking. Run `git --version` to verify.
  </Step>

  <Step title="GitHub CLI (optional)" icon="github">
    Install [`gh`](https://cli.github.com/) and run `gh auth login` if you want [Auto PR](/features/auto-pr) creation.
  </Step>
</Steps>

## Desktop App

Download the latest release for your platform:

<Columns cols={3}>
  <Card title="Windows" icon="windows" href="https://github.com/bahri-hirfanoglu/claude-board/releases/latest">
    `.exe` / `.msi` installer (x64)
  </Card>

  <Card title="macOS" icon="apple" href="https://github.com/bahri-hirfanoglu/claude-board/releases/latest">
    `.dmg` — Intel & Apple Silicon
  </Card>

  <Card title="Linux" icon="linux" href="https://github.com/bahri-hirfanoglu/claude-board/releases/latest">
    AppImage & `.deb`
  </Card>
</Columns>

### First Launch

On first launch, the [6-step setup wizard](/desktop/setup) guides you through:

1. **Language selection** — English or Turkish
2. **System check** — Validates Claude CLI, Node.js, Git, and port availability
3. **Data directory** — Where the SQLite database and uploads are stored
4. **MCP server port** — Default `4000`, auto-checks availability
5. **First project** — Creates your initial project with a working directory

<Tip>The setup wizard runs only once. You can change settings later from the app menu.</Tip>

## Build from Source

Building from source requires both **Rust** and **Node.js** toolchains.

### Prerequisites

| Tool                          | Version   | Purpose                                                             |
| ----------------------------- | --------- | ------------------------------------------------------------------- |
| [Rust](https://rustup.rs/)    | Stable    | Tauri v2 backend                                                    |
| [Node.js](https://nodejs.org) | >= 18.0.0 | React frontend & build tools                                        |
| Platform deps                 | Latest    | [Tauri v2 prerequisites](https://v2.tauri.app/start/prerequisites/) |

### Steps

```bash theme={null}
git clone https://github.com/bahri-hirfanoglu/claude-board.git
cd claude-board
npm install
npx tauri dev
```

`npx tauri dev` builds the Rust backend, starts the Vite dev server for the React frontend, and opens the app window with hot-reload enabled.

## Production Build

To produce a distributable installer:

```bash theme={null}
npx tauri build
```

The output is written to `src-tauri/target/release/bundle/` and includes platform-specific installers.

| Platform | Output                                                         |
| -------- | -------------------------------------------------------------- |
| Windows  | `.exe` and `.msi` in `bundle/msi/`                             |
| macOS    | `.dmg` in `bundle/dmg/`                                        |
| Linux    | `.deb` and `.AppImage` in `bundle/deb/` and `bundle/appimage/` |

## Verify Installation

After installing, verify everything works:

<Accordion title="Verification checklist">
  1. Launch Claude Board — you should see the setup wizard (first run) or the main board
  2. Open Settings and confirm the MCP server port is active
  3. Create a test project pointing to any code directory
  4. Create a simple task (e.g., "List all files in the project root") and move to In Progress
  5. Watch the live terminal — you should see Claude's output streaming in real-time
</Accordion>