Files
Dash/AGENTS.md
T
Tomas DvorakandDevin e88429514b feat(landing): static marketing page for Vercel
Single self-contained index.html under landing/ — no build step.
Product design tokens (dark theme, Geist + Geist Mono self-hosted,
#3b82f6 accent), hero with framed board screenshot, feature bento,
screenshots strip, install commands with copy buttons.

Deployed as Vercel project "dash" -> https://dash.vercel.app

Authored By: TDvorak <[email protected]>

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
2026-09-25 12:57:14 +02:00

1.6 KiB

Dash

Self-hosted homelab dashboard. Single Go binary serving an embedded React UI. Optional auth (off by default), no YAML. See ROADMAP.md (canonical) and docs/specs/ for design.

Layout

  • apps/frontend — React 18 + Vite + TS strict + Tailwind v4 + shadcn/ui
  • apps/backend — Go + Gin + zap, CGO-free, SQLite via modernc.org/sqlite
  • packages/api-client — generated TS client; openapi.yaml at repo root is the contract
  • landing/ — static marketing page, deployed to Vercel; no build step, plain HTML/CSS/JS
  • infra/ — Dockerfile (multi-stage, one image)
  • tools/oxlint/anti-slop — vendored lint plugin (do not extend casually)
  • data/ — runtime SQLite + uploaded icons (gitignored)

Commands

npm install
npm run generate          # regenerate TS client from openapi.yaml
npm run dev               # vite dev server (proxies /api -> :8080)
npm run typecheck         # tsc --noEmit
npm run lint              # oxlint + anti-slop rules
npm run build             # api-client types + frontend bundle

cd apps/backend
go build ./...            # build backend
go test ./...             # tests
DASH_DEV=1 go run ./cmd/dash   # dev server on :8080, no embedded UI needed

Rules

  • OpenAPI is the API contract. Never hand-write API types in the frontend.
  • All schema changes go through goose migrations in apps/backend/internal/db/migrations.
  • Board renderers share state/dnd/popover primitives; never reimplement them per renderer.
  • No emojis in code or UI.
  • Before pushing: npm run typecheck, npm run lint, npm run build, go build/vet/test ./... all green.