# token-hud

**Repository Path**: kain/token-hud

## Basic Information

- **Project Name**: token-hud
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-21
- **Last Updated**: 2026-06-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Claude HUD PlatformIO

Arduino/PlatformIO implementation for the ESP32-S3 1.69-inch token HUD.

## Stack

- PlatformIO + Arduino framework
- WiFiManager for Wi-Fi provisioning and captive portal
- Preferences/NVS for API endpoint, token, and `New-Api-User`
- HTTPClient + WiFiClientSecure for HTTPS API calls
- ArduinoJson for response parsing
- TFT_eSPI for ST7789 display

## Provisioning Flow

On boot the device tries saved Wi-Fi first. If no Wi-Fi is saved or connection fails, `WiFiManager` starts a captive portal:

```text
Claude-HUD-xxxx
```

The portal also exposes custom fields:

- API endpoint
- API bearer token
- `New-Api-User`

Successful Wi-Fi credentials are stored by the Arduino Wi-Fi stack. API settings are stored in Preferences namespace `hud`.

## Build

Open this folder in VS Code with PlatformIO and build/upload the default environment:

```powershell
pio run -t upload
```

Use normal upload to preserve NVS. Do not use erase-flash unless you want to clear Wi-Fi and API settings.

## Configuration

Fallback defaults are in `platformio.ini` build flags:

```ini
-D CLAUDE_HUD_API_ENDPOINT=\"\"
-D CLAUDE_HUD_API_TOKEN=\"\"
-D CLAUDE_HUD_API_USER=\"\"
```

Portal values take priority once saved.