tronbyt/CLAUDE.md
Corey Johnson 66d0d61c34 Update documentation and remove postinstall script
README now includes full setup instructions, troubleshooting, account creation, and system apps fix. CLAUDE.md streamlined to codebase reference. postinstall.sh removed — binary auto-downloads via src/binary.ts on first run.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-03-11 09:39:59 -07:00

22 lines
971 B
Markdown

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