Dashboard

A live dashboard with 6 views, accessible at /__brakit on your dev server.

Accessing the Dashboard

Once brakit is running, open your browser and navigate to:

http://localhost:<your-port>/__brakit

The dashboard is served on the same port as your running app. Replace <your-port> with whatever port your dev server uses (e.g. 3000, 5173, 8080).

Real-Time Updates

The dashboard uses Server-Sent Events (SSE) to stream data in real-time. As your app handles requests, you'll see them appear instantly without refreshing.

Use the Clear button to reset all captured data and start fresh. This is useful when you want to isolate a specific user flow.

Views

Overview

Summary cards showing actions count, issues (critical/warning), performance status, error breakdown, and graph stats. Your at-a-glance view of the entire backend.

Actions

HTTP requests grouped by user action. Navigate to a page? That's one action. Submit a form? Another. Each action shows its requests, redundancy %, timing, and flagged issues.

Insights

Security findings, error patterns, and issue tracking in one unified view. Filter by All, Security, Performance, or Quality. Each issue tracks its lifecycle and resolution progress.

Performance

Heat map and scatter chart of request latencies. Endpoint drill-down with query breakdown and query shape aggregation. Health grades, p95 latency trends, and historical data from previous sessions. Regression detection flags when p95 latency or query counts increase.

Graph

Runtime dependency graph visualizing how actions, endpoints, database tables, and external services connect. Overlay layers for auth security, performance, issues, and heat. Includes flow tracing, search/filter, minimap, zoom, and keyboard navigation.

Explorer

Browse raw telemetry with sub-tabs for Requests, Fetches, Queries, Logs, and Errors. Each has expandable detail panels with full request/response data, SQL, stack traces, and timing.

Dashboard API

The dashboard is powered by a set of JSON API endpoints, all under /__brakit/api/:

EndpointDescription
/__brakit/api/requestsAll captured HTTP requests
/__brakit/api/flowsGrouped request flows (actions)
/__brakit/api/eventsSSE stream for real-time updates
/__brakit/api/logsConsole output
/__brakit/api/fetchesServer-side fetch calls
/__brakit/api/errorsCaptured errors
/__brakit/api/queriesDatabase queries
/__brakit/api/metricsPerformance metrics
/__brakit/api/graphDependency graph data (endpoints, tables, services)
/__brakit/api/insightsComputed analysis issues (performance and reliability)
/__brakit/api/securitySecurity issues
/__brakit/api/findingsAll stateful issues for MCP/AI consumption
/__brakit/api/findings/reportRecord AI fix result (POST)
/__brakit/api/metrics/liveLive per-endpoint time-series data
/__brakit/api/activityRequest activity timeline
/__brakit/api/tabTrack active dashboard tab
/__brakit/api/ingestTelemetry ingestion (POST, from hooks and SDKs)
/__brakit/api/clearClear all data (POST)