# Tronbyt Toes App

This is a [toes](/Users/corey/code/toes) app. See the [toes CLAUDE.md](/Users/corey/code/toes/CLAUDE.md) for the framework docs.

Wraps the Tronbyt Go server (self-hosted Tidbyt replacement) as a toes-managed subprocess. Bun proxies all HTTP and WebSocket traffic to the Go binary over a unix socket.

## How It Works

```
Tidbyt device → tronbyt.toes.local → toes → Bun (PORT) → Go binary (unix socket)
```

- `src/server/index.tsx` — spawns Go binary, proxies HTTP + WebSocket, health checks
- `bin/` — pre-built Go binary (gitignored, per-platform)
- No UI of its own — Go server serves its own web dashboard

## Setup

1. Download the binary for your platform from https://github.com/tronbyt/server/releases
2. Place it in `bin/` (e.g. `bin/tronbyt-server-darwin-arm64`)
3. `chmod +x bin/tronbyt-server-*`
4. On macOS: System Settings → Privacy & Security → Allow Anyway

## Env Vars

Toes provides `PORT`, `DATA_DIR`, `APPS_DIR`, `TOES_URL`, `APP_URL`.

Tronbyt-specific vars (set via toes env config):
- `PRODUCTION` — `true` enables firmware downloads and system apps (default)
- `SINGLE_USER_AUTO_LOGIN` — `true` for home network (default)
- `SYSTEM_APPS_AUTO_REFRESH` — `true` to keep community apps updated (default)

## Device Config

Set the Tidbyt Image URL to:
```
http://tronbyt.toes.local/<device-id>/next
```