CodeRadius LogoCodeRadius Docs
Explore

Architecture Dashboard

The unified visual intelligence layer — a single-page report for architectural health, AI adoption, dependency governance, and blast radius analysis.

Architecture Dashboard

The Architecture Dashboard is a self-contained, interactive HTML report that surfaces the full architectural health of your engineering organization in a single view — from service inventory and team ownership to dependency drift, SPOF analysis, and AI tooling adoption.

Start with Governance, Impact Evaluation, or MCP Server if you're evaluating CodeRadius for the first time. The dashboard is the reporting layer on top of those workflows.

cr ui

The command connects to your Memgraph instance, executes all analytical queries concurrently, and renders the results into a zero-dependency HTML file that opens automatically in your default browser.


Dashboard Domains

The dashboard is organized into five architectural domains, each accessible via the sidebar navigation:

DomainSidebar LabelWhat It Shows
System RegistrySystem RegistryAuto-generated service catalog: repositories, services, teams
Impact ExplorerImpact ExplorerInteractive topology graph of cross-service dependencies
Agentic RadarAgentic RadarAI tooling adoption, maturity matrix, context gaps
SPOFsSPOFsSingle Points of Failure, data monoliths, service bottlenecks
DependenciesDependenciesPackage inventory, internal registry, version adoption health

Each domain has its own dedicated documentation page linked below.


Generating the Dashboard

Basic Usage

# Generate and auto-open in browser
cr ui

# Write to a specific file
cr ui --out ./reports/health-$(date +%Y-%m-%d).html

# Focus on a single domain
cr ui --focus gravity

# Output raw JSON for CI/headless pipelines
cr ui --json

Options Reference

OptionDefaultDescription
--out <file>Auto-generated temp fileWrite the HTML report to a specific path instead of auto-opening
--focus <domain>All domainsRender only one domain. Values: inventory, impact, agentic-radar, gravity, deps
--jsonfalseOutput the raw JSON payload to stdout (no HTML rendering)
--cifalseAlias for --json — designed for CI/CD pipeline integration

When --focus is used, the sidebar is suppressed and the dashboard renders as a single-domain report. This is useful for embedding in Slack notifications, stakeholder emails, or CI artifacts.

CI/CD Automation

Schedule the dashboard as a weekly artifact in your CI pipeline:

name: "Weekly Architecture Health Report"
on:
  schedule:
    - cron: '0 8 * * 1'  # Every Monday at 08:00 UTC

jobs:
  dashboard:
    runs-on: ubuntu-latest
    steps:
      - name: Install CodeRadius
        run: curl -sSL https://cdn.coderadius.ai/install.sh | bash

      - name: Generate Dashboard
        env:
          MEMGRAPH_URI: ${{ secrets.CODERADIUS_MEMGRAPH_URI }}
        run: cr ui --out health-report.html

      - name: Upload Artifact
        uses: actions/upload-artifact@v4
        with:
          name: architecture-dashboard
          path: health-report.html
architecture_dashboard:
  stage: report
  image: node:20-alpine
  before_script:
    - curl -sSL https://cdn.coderadius.ai/install.sh | bash
  script:
    - cr ui --out health-report.html
  artifacts:
    paths:
      - health-report.html
    expire_in: 30 days
  rules:
    - if: $CI_PIPELINE_SOURCE == "schedule"

Reading the Header Stats Bar

The top of the dashboard displays a horizontal bar of key performance indicators. These KPIs are aggregated from all active domains. Each domain contributes its own metrics:

MetricSource DomainMeaning
RegisteredSystem RegistryTotal repositories in the graph
Known VulnerabilitiesSPOFsCount of resources with a SPOF score ≥ 80
Avg MaturityAgentic RadarMean agentic maturity level (L0–L4) across active repos
Context GapsAgentic RadarCross-team duplicate configurations detected

When using --focus, only the metrics relevant to the focused domain are shown.


Understanding the Sidebar

The sidebar provides domain-level navigation. Each entry shows:

  • The domain icon and label
  • A page title and subtitle describing the domain's purpose
  • Domain-specific header stats that replace the global bar when that domain is selected

Clicking a sidebar entry scrolls to the corresponding domain and updates the header stats to reflect domain-specific KPIs.


Domain Deep-Dives

Each domain has comprehensive documentation:

  • System Registry — The auto-generated service catalog: repositories, services, teams, depth, and liveness data.
  • Impact Explorer — Interactive topology visualization of cross-service dependencies and blast radius analysis.
  • Agentic Radar — AI tooling adoption metrics, maturity matrix, capabilities catalog, context gaps, and principal engineer playbooks.
  • SPOFs & Data Gravity — Single Points of Failure detection, data monolith scoring, and service bottleneck ranking.
  • Dependencies — Package inventory, internal registry adoption health, and version drift analysis.

JSON Output Schema

When using --json or --ci, the dashboard outputs a structured JSON payload suitable for programmatic consumption:

# Pipe to jq for inspection
cr ui --json | jq '.inventory.summary'

# Save to file
cr ui --json > dashboard-$(date +%Y%m%d).json

The JSON payload contains one key per domain (inventory, topology, radar, gravity, deps), each with the full data set used to render that domain's UI. This allows you to build custom dashboards, Slack bots, or monitoring integrations on top of CodeRadius data.


Further Reading

On this page