tronbyt/CLAUDE.md

Tronbyt Toes App

This is a toes app. See the 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.

Key Files

• src/server.ts — entry point, creates Bun server, calls spawn
• src/proxy.ts — HTTP + WebSocket proxy from Bun to Go binary on port 8000
• src/binary.ts — Go binary lifecycle: download, spawn, health checks, shutdown
• bin/ — Go binary (gitignored, auto-downloaded per-platform)

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)