SysDeck/web/README.md

1.3 KiB

SysDeck Web Edition

The browser-native rendition of SysDeck: 28 bridge modules behind one console — real /proc + /sys collectors where the host allows, honest demo datasets (clearly badged) where backends are absent, and the Fester DAG orchestrator vendored as a dedicated service (mini-services/fester).

Run (Bun)

bun install
bun run db:push                        # create + migrate db/custom.db (SQLite)
(cd mini-services/fester && bun install)
bun run dev                            # Next.js on :3000
(cd mini-services/fester && bun run dev)   # fester service on :3010

Then open http://localhost:3000. The Fester panel proxies REST through /api/fester and streams WebSocket events through the gateway (/?XTransformPort=3010).

Layout

  • src/lib/sysdeck/ — module registry + bridge dispatcher modules
  • src/app/api/bridge — the bridge endpoint (POST {module, command, args})
  • src/app/api/fester — server-side proxy to the fester service
  • src/app/api/release — master-tarball release metadata
  • src/components/sysdeck/ — panels + shared UI primitives
  • mini-services/fester — the vendored Fester service (own package, v0.2.1)

db/custom.db is created by bun run db:push using DATABASE_URL from .env. The master tarball builder lives at scripts/make-master-tarball.sh in the canonical development tree.