66 lines
2.5 KiB
Markdown
66 lines
2.5 KiB
Markdown
# dashboard
|
|
|
|
A terminal dashboard (TUI) built with [go-tui](https://github.com/grindlemire/go-tui). Shows simulated CPU/memory/disk gauges, network sparklines, and a scrolling event feed. Single binary, no external services — everything is randomly generated for demo purposes.
|
|
|
|
## Requirements
|
|
|
|
- Go 1.24+ (module targets 1.26.5)
|
|
|
|
## Getting started
|
|
|
|
```sh
|
|
# Regenerate dashboard_gsx.go from dashboard.gsx (required if the .go file is missing/stale)
|
|
go run github.com/grindlemire/go-tui/cmd/tui generate ./...
|
|
|
|
# Run the app
|
|
go run .
|
|
```
|
|
|
|
## Commands
|
|
|
|
```sh
|
|
# Regenerate dashboard_gsx.go from dashboard.gsx
|
|
go run github.com/grindlemire/go-tui/cmd/tui generate ./...
|
|
|
|
# Build
|
|
go build ./...
|
|
|
|
# Vet
|
|
go vet ./...
|
|
|
|
# Run
|
|
go run .
|
|
```
|
|
|
|
There are no test files in this repo yet.
|
|
|
|
## Controls
|
|
|
|
- `q` / `Esc` — quit
|
|
- `j` / `k` or arrow keys — scroll the event feed
|
|
- Mouse wheel — scroll the event feed
|
|
|
|
## Architecture
|
|
|
|
`dashboard.gsx` is the source of truth for the UI, written in `.gsx` — a JSX-like DSL (Tailwind-esque `class` strings, `{expr}` interpolation, `for`/`if` control flow) provided by go-tui. It also contains the non-templ Go code: the `dashboardApp` struct, helper funcs, and `produceEvents`.
|
|
|
|
Running `tui generate` compiles `dashboard.gsx` into `dashboard_gsx.go`. That generated file is git-ignored and carries a `// Code generated by tui generate. DO NOT EDIT.` header — never hand-edit it. To change the UI, edit `dashboard.gsx` and regenerate.
|
|
|
|
`main.go` wires up `tui.NewApp(tui.WithRootComponent(Dashboard(eventCh)), tui.WithMouse())` and runs it. A background goroutine (`produceEvents`) pushes random events onto `eventCh`.
|
|
|
|
`dashboardApp` implements several optional go-tui interfaces (checked at compile time in the generated file):
|
|
|
|
- `KeyMap()` — key bindings
|
|
- `HandleMouse()` — mouse wheel scroll support
|
|
- `Watchers()` — background subscriptions (a 500ms metrics-drift timer, an event-channel watch)
|
|
- `Render()` — the generated view tree
|
|
- `BindApp()` — generated; wires every `*tui.State[T]` field so state changes trigger re-renders
|
|
|
|
All mutable UI state (`cpu`, `mem`, `sparkIn`, `events`, `scrollY`, ...) is `*tui.State[T]`, read via `.Get()` and mutated via `.Set()`.
|
|
|
|
See [CLAUDE.md](CLAUDE.md) for more detail on the code-generation step and conventions.
|
|
|
|
## CI
|
|
|
|
`.gitea/workflows/build.yml` runs on push/PR to `main`: checkout → setup-go → `tui generate` → `go build` → `go vet`. The generated file is never committed — CI regenerates it from scratch every run.
|