User guide

The guides below explain each dashboard section: displayed data, available actions, state-dependent controls, API calls and known limitations. Screenshots illustrate the main operator pages; use the verification matrix for current test coverage.

Screenshots were captured against a live seeded server (queues emails, image-resize, reports, notifications, benchmark, maintenance; real completed jobs, DLQ entries, cron schedules, webhooks and workers) in the default dark theme.

Two page families, by design

The Pro pages (src/pages/control/*, client lib/bq.ts) are the complete control surface and own the sidebar, they're documented below. The first-generation classic pages remain reachable at *-classic routes and are covered in the Classic pages appendix. For the full route → component → API-client table, see Pages & routes.

Home

• Overview, the landing page: connection banner, headline stat cards, per-queue health grid, and a live activity feed.
• Fleet, health and lifecycle control for multiple Bunqueue brokers, paired agents, and shared PostgreSQL topology.

Queues

• Queues, the fleet view: every queue with per-state counts and inline pause/resume.
• Jobs Explorer, server-paginated jobs for a queue, with filters, multi-select and Promote as the only job-lifecycle mutation.
• Dead Letter Queue, cross-queue DLQ dashboard: reasons, attempt history and CSV export; every retry and purge path fails closed.
• Cron Jobs, list and create scheduled jobs (cron expression or interval).

Workflow

• Workflow Engine, a dedicated command centre with Overview, Executions, Waiting & Signals, Compensation, and Archive views.
• Job Flows, DAG exploration, all five FlowProducer create modes, dependency/result tools, and safe Flow Job methods.

Monitoring

• Metrics, rolling throughput chart, queue-depth trend, latency percentiles, per-queue counts.
• Workers, registered workers, active/stale status, and guarded stale-worker registry cleanup (it does not stop worker processes).
• Logs, the live SSE event feed with filters and search.
• Alerts, browser-local thresholds, triggered rules and delivery limits.

Control

• Server Control, start / stop / restart the bunqueue process via the local control agent, with live logs.
• Add Job, enqueue a job with payload, options, priority and delay.
• Bulk Add Jobs, import validated JSON or NDJSON into one queue.
• Job Inspector, a single job's full timeline, payload, result and state-gated actions.
• Queue Control, per-queue actions, live Queue SDK limits/deduplication/metrics/journal tools, and stall/DLQ configuration; DLQ retention is read-only.
• DLQ Control, read-only single-queue dead-letter triage.
• Webhooks, register, enable/disable and remove webhook endpoints.
• Diagnostics, connectivity and health checks.
• Benchmark, drive synthetic load and watch throughput.

Management

• Database, the read-only SQLite inspector: tables, schema, rows, and query runner.
• MCP Server, install and connect the separate stdio server.
• Copilot, switched off in official builds; how to enable it in a custom build.
• Usage, cumulative usage totals and runtime/storage facts.
• S3 Backup, live configuration, status, listing, on-demand snapshots, and guarded restore through the local control agent.
• Settings, named broker/agent profiles, isolated session credentials, polling interval, and theme.

Appendix

• Classic pages, the first-generation view pages, kept intact, and the 404 catch-all.