DurableDashboard

LiveView-first web console for the Durable workflow engine.

The dashboard renders server-side via Phoenix LiveView, with a single ReactFlow island for the workflow-graph view. No SPA, no separate API — just one router macro.

Features

• Overview — live status counts and recent executions
• Workflows — catalog of registered workflows (run counts, last status), derived from execution history
• Executions — every run, with a faceted filter bar: pick a workflow (autocomplete), multi-select status, a relative/custom time range, or an execution id (prefix filter + jump). Filters live in the URL, so views are shareable
• Execution detail — Summary, Flow graph, Timeline (absolute-time Gantt), Logs, I/O, and History (trace spine), plus a Family tab for parent/child runs
• Pending inputs — surface and resolve human-in-the-loop steps
• Schedules — toggle, trigger, and inspect cron-driven workflows
• Settings — inspect Durable's runtime configuration
• ⌘K command palette — jump to any page, workflow, or recent run
• Copy buttons — one-click copy on JSON payloads, ids, and config values

Installation

Add durable_dashboard alongside durable:

def deps do
  [
    {:durable, "~> 1.0"},
    {:durable_dashboard, "~> 1.0"}
  ]
end

Usage

Mount the dashboard at any path in your host router:

defmodule MyAppWeb.Router do
  use MyAppWeb, :router

  # ...your existing pipelines and scopes...

  use DurableDashboard.Router, mount: "/dashboard", durable: MyApp.Durable
end

The macro emits the dashboard's pipelines, asset routes, and live routes inline in your router. It must live at the top level — not inside a scope or pipe_through block, since it defines its own pipelines.

Options

• :mount — URL prefix the dashboard mounts at (required)
• :durable — Durable instance name (default: Durable)
• :live_socket_path — path your endpoint uses for Phoenix.LiveView.Socket (default: "/live")
• :on_mount — list of on_mount hooks the host wants to inject for auth or other concerns (default: [])

URL surface

The macro emits these routes under your :mount prefix:

• GET / — Overview
• GET /workflows — workflow catalog
• GET /workflows/:name — executions for one workflow
• GET /executions — all executions (faceted filters)
• GET /executions/:id[/:tab] — execution detail (Summary / Flow / Timeline / Logs / I/O / History)
• GET /inputs
• GET /schedules
• GET /settings
• GET /__assets__/* — CSS/JS/font assets

Authentication

Inject your host app's auth via :on_mount hooks — the dashboard does not ship its own auth layer:

use DurableDashboard.Router,
  mount: "/dashboard",
  durable: MyApp.Durable,
  on_mount: [{MyAppWeb.UserAuth, :ensure_authenticated}]

Design

DESIGN.md codifies the design language: tokens, typography, spacing, motion, status semantics, component primitives, and composition patterns. New visual decisions are made there first, then applied in code.

License

MIT