# tronbyt/server architecture

> Architecture diagram of the GitHub repository tronbyt/server, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tronbyt/server
- Repository: https://github.com/tronbyt/server

## Overview

Tronbyt Server is a self-hosted application manager and display service for Tronbyt-compatible devices. The principal workflow is: a user signs in, adds a device, discovers or configures an app, and the device retrieves rendered images for display. The repository also supports firmware generation, device APIs, repository-backed apps, legacy migration, and monitoring. The README documents the product workflow and capabilities; several internal connections are shown as unverified because the relevant handler and orchestration source was not excerpted.

Main entry points: [`internal/server/server.go`](https://github.com/tronbyt/server/blob/main/internal/server/server.go) (HTTP server), [`internal/server/handlers_app.go`](https://github.com/tronbyt/server/blob/main/internal/server/handlers_app.go) (App management), [`internal/data/models.go`](https://github.com/tronbyt/server/blob/main/internal/data/models.go) (Domain models), [`web/static/js/manager.js`](https://github.com/tronbyt/server/blob/main/web/static/js/manager.js) (Web interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and UI"]
  node_web["Web interface<br/>[manager.js]"]
  node_auth["Authentication<br/>[auth.go]"]
  node_user_handlers["User management<br/>[handlers_user.go]"]
  node_server["HTTP server<br/>[server.go]"]
  node_theme["Theme controls<br/>[theme.js]"]
end

subgraph group_apps["Apps and Rendering"]
  node_app_handlers["App management<br/>[handlers_app.go]"]
  node_app_catalog["App catalog<br/>[apps.go]"]
  node_git["App repositories<br/>[git.go]"]
  node_renderer["Pixlet rendering<br/>[renderer.go]"]
  node_render_cache["Render cache<br/>[cache.go]"]
end

subgraph group_devices["Devices and Firmware"]
  node_device_handlers["Device management<br/>[handlers_device.go]"]
  node_device_api["Device API<br/>[handlers_api.go]"]
  node_device_api_routes["Device endpoints"]
  node_firmware["Firmware generation<br/>[firmware.go]"]
end

subgraph group_persistence["Persistence and Migration"]
  node_models["Domain models<br/>[models.go]"]
  node_database[("Database<br/>[database.go]")]
  node_legacy["Legacy migration<br/>[converter.go]"]
end

subgraph group_operations["Operations"]
  node_metrics["Metrics<br/>[metrics.go]"]
  node_broadcaster["Live updates<br/>[broadcaster.go]"]
end

node_user(("User"))
node_device(("Display client"))

node_user -->|"manages devices"| node_web
node_web -.->|"signs in"| node_auth
node_web -.->|"configures apps"| node_app_handlers
node_web -->|"adds device"| node_device_handlers
node_device -->|"requests images"| node_device_api
node_server -.->|"routes requests"| node_auth
node_server -.->|"routes requests"| node_user_handlers
node_server -.->|"routes requests"| node_app_handlers
node_server -.->|"routes requests"| node_device_handlers
node_server -.->|"routes requests"| node_device_api_routes
node_app_handlers -.->|"lists apps"| node_app_catalog
node_app_handlers -.->|"renders preview"| node_renderer
node_renderer -.->|"uses cache"| node_render_cache
node_git -.->|"provides repository apps"| node_app_catalog
node_device_handlers -->|"generates firmware"| node_firmware
node_device_api -.->|"reads and updates"| node_models
node_app_handlers -.->|"reads and updates"| node_models
node_device_handlers -.->|"reads and updates"| node_models
node_database -.->|"stores records"| node_models
node_legacy -->|"converts records"| node_models
node_server -->|"exposes metrics"| node_metrics
node_server -.->|"publishes updates"| node_broadcaster
node_user -.->|"customizes display"| node_theme

click node_web "https://github.com/tronbyt/server/blob/main/web/static/js/manager.js"
click node_auth "https://github.com/tronbyt/server/blob/main/internal/server/auth.go"
click node_user_handlers "https://github.com/tronbyt/server/blob/main/internal/server/handlers_user.go"
click node_server "https://github.com/tronbyt/server/blob/main/internal/server/server.go"
click node_app_handlers "https://github.com/tronbyt/server/blob/main/internal/server/handlers_app.go"
click node_app_catalog "https://github.com/tronbyt/server/blob/main/internal/apps/apps.go"
click node_git "https://github.com/tronbyt/server/blob/main/internal/gitutils/git.go"
click node_renderer "https://github.com/tronbyt/server/blob/main/internal/renderer/renderer.go"
click node_render_cache "https://github.com/tronbyt/server/blob/main/internal/pixletcache/cache.go"
click node_device_handlers "https://github.com/tronbyt/server/blob/main/internal/server/handlers_device.go"
click node_device_api "https://github.com/tronbyt/server/blob/main/internal/server/handlers_api.go"
click node_device_api_routes "https://github.com/tronbyt/server/blob/main/internal/server/handlers_device_api.go"
click node_firmware "https://github.com/tronbyt/server/blob/main/internal/firmware/firmware.go"
click node_models "https://github.com/tronbyt/server/blob/main/internal/data/models.go"
click node_database "https://github.com/tronbyt/server/blob/main/internal/data/database.go"
click node_legacy "https://github.com/tronbyt/server/blob/main/internal/legacy/converter.go"
click node_metrics "https://github.com/tronbyt/server/blob/main/internal/server/metrics.go"
click node_broadcaster "https://github.com/tronbyt/server/blob/main/internal/sync/broadcaster.go"
click node_theme "https://github.com/tronbyt/server/blob/main/web/static/js/theme.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web,node_auth,node_user_handlers,node_server,node_theme,node_user,node_device toneBlue
class node_app_handlers,node_app_catalog,node_git,node_renderer,node_render_cache toneAmber
class node_device_handlers,node_device_api,node_device_api_routes,node_firmware toneMint
class node_models,node_database,node_legacy toneRose
class node_metrics,node_broadcaster toneIndigo
```

## Components

### Access and UI

- [Web interface](https://github.com/tronbyt/server/blob/main/web/static/js/manager.js): `web/static/js/manager.js`
- [Authentication](https://github.com/tronbyt/server/blob/main/internal/server/auth.go): `internal/server/auth.go`
- [User management](https://github.com/tronbyt/server/blob/main/internal/server/handlers_user.go): `internal/server/handlers_user.go`
- [HTTP server](https://github.com/tronbyt/server/blob/main/internal/server/server.go): `internal/server/server.go`
- [Theme controls](https://github.com/tronbyt/server/blob/main/web/static/js/theme.js): `web/static/js/theme.js`

### Apps and Rendering

- [App management](https://github.com/tronbyt/server/blob/main/internal/server/handlers_app.go): `internal/server/handlers_app.go`
- [App catalog](https://github.com/tronbyt/server/blob/main/internal/apps/apps.go): `internal/apps/apps.go`
- [App repositories](https://github.com/tronbyt/server/blob/main/internal/gitutils/git.go): `internal/gitutils/git.go`
- [Pixlet rendering](https://github.com/tronbyt/server/blob/main/internal/renderer/renderer.go): `internal/renderer/renderer.go`
- [Render cache](https://github.com/tronbyt/server/blob/main/internal/pixletcache/cache.go): `internal/pixletcache/cache.go`

### Devices and Firmware

- [Device management](https://github.com/tronbyt/server/blob/main/internal/server/handlers_device.go): `internal/server/handlers_device.go`
- [Device API](https://github.com/tronbyt/server/blob/main/internal/server/handlers_api.go): `internal/server/handlers_api.go`
- [Device endpoints](https://github.com/tronbyt/server/blob/main/internal/server/handlers_device_api.go): `internal/server/handlers_device_api.go`
- [Firmware generation](https://github.com/tronbyt/server/blob/main/internal/firmware/firmware.go): `internal/firmware/firmware.go`

### Persistence and Migration

- [Domain models](https://github.com/tronbyt/server/blob/main/internal/data/models.go): `internal/data/models.go`
- [Database](https://github.com/tronbyt/server/blob/main/internal/data/database.go): `internal/data/database.go`
- [Legacy migration](https://github.com/tronbyt/server/blob/main/internal/legacy/converter.go): `internal/legacy/converter.go`

### Operations

- [Metrics](https://github.com/tronbyt/server/blob/main/internal/server/metrics.go): `internal/server/metrics.go`
- [Live updates](https://github.com/tronbyt/server/blob/main/internal/sync/broadcaster.go): `internal/sync/broadcaster.go`

### Other components

- **User**
- **Display client**

## Connections

- User → Web interface: manages devices (evidence: `README.md`)
- Web interface → Authentication: signs in
- Web interface → App management: configures apps
- Web interface → Device management: adds device (evidence: `README.md`)
- Display client → Device API: requests images (evidence: `README.md`)
- HTTP server → Authentication: routes requests
- HTTP server → User management: routes requests
- HTTP server → App management: routes requests
- HTTP server → Device management: routes requests
- HTTP server → Device endpoints: routes requests
- App management → App catalog: lists apps
- App management → Pixlet rendering: renders preview
- Pixlet rendering → Render cache: uses cache
- App repositories → App catalog: provides repository apps
- Device management → Firmware generation: generates firmware (evidence: `README.md`)
- Device API → Domain models: reads and updates
- App management → Domain models: reads and updates
- Device management → Domain models: reads and updates
- Database → Domain models: stores records
- Legacy migration → Domain models: converts records (evidence: `internal/legacy/converter.go`)
- HTTP server → Metrics: exposes metrics (evidence: `README.md`)
- HTTP server → Live updates: publishes updates
- User → Theme controls: customizes display
