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

> Native OS notifications for task events with per-event toggles and localization

Claude Board sends **native desktop notifications** when important task events occur. Notifications use the operating system's notification system — Windows toast notifications and macOS Notification Center.

## Supported Events

Each event type can be independently enabled or disabled in [App Settings](/features/settings):

| Event                  | Default | Description                                          |
| ---------------------- | ------- | ---------------------------------------------------- |
| **Task Completed**     | On      | Claude finished working on a task (moved to Testing) |
| **Task Failed**        | On      | A task failed or exited with an error                |
| **Task Started**       | Off     | Claude started working on a task                     |
| **Revision Requested** | On      | Revision feedback was sent to Claude                 |
| **Queue Auto-Started** | Off     | A task was automatically started from the queue      |

Auto-test results also trigger notifications:

* **Test Passed** uses the Task Completed toggle
* **Test Failed** uses the Task Failed toggle

## Notification Format

Notifications include the **task key** for easy identification:

```
Claude Board — Task Completed
[FTR-CB-1042] Implement login page
✔ Completed — ready for review
```

### Event Icons

Each event type uses a distinctive symbol:

| Event     | Symbol |
| --------- | ------ |
| Started   | ▶      |
| Completed | ✔      |
| Failed    | ✘      |
| Revision  | ↻      |
| Queue     | ⏵      |

## Localization

Notification titles and messages follow the **language setting** in App Settings. When Turkish is selected, notifications appear in Turkish:

```
Claude Board — Gorev Tamamlandi
[FTR-CB-1042] Login sayfasi
✔ Tamamlandi — inceleme bekliyor
```

## App Icon

The Claude Board app icon is displayed in notifications on both platforms. On Windows, the app icon appears in the toast notification header. On macOS, it appears as the notification sender icon.

## Platform Support

| Platform          | Notification System      | App Icon                    |
| ----------------- | ------------------------ | --------------------------- |
| **Windows 10/11** | Toast notifications      | Automatic from app manifest |
| **macOS 10.15+**  | UNUserNotificationCenter | Automatic from app bundle   |

<Info>Notification sounds are controlled by your operating system notification settings.</Info>

## Configuration

Toggle notifications in **App Settings → Notifications**:

1. Open App Settings (gear icon on Dashboard)
2. Click the **Notifications** tab
3. Toggle individual event types on/off

All changes take effect immediately.