Skip to content

18 Dashboard UI Guide

Heinrich Krupp edited this page Nov 5, 2026 · 2 revisions

Dashboard UI Guide

Current dashboard changes (v12.5-v12.6)

Updated 2026-11-05:

  • The default theme follows the system color scheme; an explicit light or dark choice takes precedence.
  • The interface has ten language catalogs, including Russian, Hindi, Indonesian and Brazilian Portuguese. Search counts, dialogs, analytics, credentials and graph controls now follow the selected language.
  • Delta-sync status shows peers, cursors, cycle results and errors. SSE updates refresh the dashboard, with a 30-second fallback.
  • Memory Growth is a line chart of the running total over the selected period.

The screenshots and version-labelled walkthrough below describe earlier releases. See the release notes for current behavior.

📌 Navigation: Home | Quality System | Web Dashboard | Features Version: 8.48.0+ (Dark mode in v8.45.2) Status: ✅ Production Ready Last Updated: December 7, 2025


Overview

The Web Dashboard (http://127.0.0.1:8000/) provides a comprehensive UI for managing memories with full Quality System integration introduced in v8.45.0-v8.45.2.

Quality System UI Features (v8.45.0+)

  • ✅ Quality badges on all memory cards (color-coded by tier)
  • ✅ Analytics view with distribution charts (bar + pie)
  • ✅ Provider breakdown visualization (onnx_local, groq, gemini, implicit)
  • ✅ Top/bottom performers lists
  • ✅ Dark mode Chart.js integration (v8.45.2)
  • ✅ Settings panel for quality configuration
  • ✅ i18n support (English + Chinese)

Quality Badges

Visual Indicators

Color-Coded Tiers:

  • 🟢 High Quality (≥0.7): Green badge, preserved 365 days
  • 🟡 Medium Quality (0.5-0.7): Yellow badge, preserved 180 days
  • 🔴 Low Quality (<0.5): Red badge, archived 30-90 days
  • ⚪ Unscored (null): Gray badge, default retention

Badge Location: Top-right corner of each memory card

Example:

<div class="memory-card">
  <div class="memory-header">
    <h3>FastAPI async patterns</h3>
    <span class="quality-badge quality-high">0.85</span> <!-- Green -->
  </div>
  <div class="memory-content">...</div>
  <div class="memory-metadata">
    <span>Provider: onnx_local</span>
    <span>Accessed: 12 times</span>
  </div>
</div>

Analytics View

Quality Distribution Chart (Bar Chart)

Metrics:

  • Total memories count
  • High quality count (≥0.7)
  • Medium quality count (0.5-0.7)
  • Low quality count (<0.5)
  • Average quality score

Example Data:

{
  "total": 3755,
  "high": 1611,     // 42.9%
  "medium": 121,    // 3.2%
  "low": 2023,      // 53.9%
  "average": 0.468
}

Visual: Horizontal bar chart with color-coded segments

Provider Breakdown (Pie Chart)

Providers:

  • onnx_local: 3750 (99.9%) - Default local SLM
  • groq: 5 (0.1%) - Cloud API fallback
  • gemini: 0 (0%) - Cloud API fallback
  • implicit: 100 (2.7%) - Access pattern scoring

Visual: Pie chart with provider colors (green/blue/purple/gray)


Dark Mode (v8.45.2)

Problem Solved

Before v8.45.2:

  • Form controls had white backgrounds in dark mode
  • Select elements didn't respect dark theme
  • Chart.js used light text on light backgrounds
  • Quality tab charts had poor contrast

After v8.45.2:

  • Global .form-control and .form-select dark mode overrides
  • Chart.js dynamic color configuration
  • Quality distribution chart with var(--neutral-400) backgrounds
  • Quality provider chart with dark mode-aware legend

Implementation

/* Global dark mode overrides */
body.dark-mode .form-control,
body.dark-mode .form-select {
    background-color: var(--neutral-800);
    border-color: var(--neutral-600);
    color: var(--neutral-100);
}

body.dark-mode .form-control:focus,
body.dark-mode .form-select:focus {
    background-color: var(--neutral-700);
    border-color: var(--primary-500);
    color: var(--neutral-100);
}

/* View button hover states */
body.dark-mode .view-btn {
    background-color: var(--primary-600);
    color: var(--neutral-100);
}

body.dark-mode .view-btn:hover {
    background-color: var(--primary-500);
}

Chart.js Integration

// Apply theme to Chart.js instances
function applyTheme(isDark) {
    const textColor = isDark ? '#f9fafb' : '#111827';  // neutral-50 : neutral-900
    const gridColor = isDark ? '#374151' : '#e5e7eb';  // neutral-700 : neutral-200

    Chart.defaults.color = textColor;
    Chart.defaults.borderColor = gridColor;

    // Update existing charts
    Object.values(Chart.instances).forEach(chart => {
        chart.options.scales.x.ticks.color = textColor;
        chart.options.scales.y.ticks.color = textColor;
        chart.options.scales.x.grid.color = gridColor;
        chart.options.scales.y.grid.color = gridColor;
        chart.update();
    });
}

// Dynamic chart colors
function renderQualityDistributionChart(data) {
    const isDark = document.body.classList.contains('dark-mode');
    const bgColor = isDark ? 'rgba(55, 65, 81, 0.8)' : 'rgba(243, 244, 246, 0.8)';  // neutral-700 : neutral-100

    new Chart(ctx, {
        type: 'bar',
        data: {
            labels: ['High', 'Medium', 'Low'],
            datasets: [{
                data: [data.high, data.medium, data.low],
                backgroundColor: [
                    'rgba(34, 197, 94, 0.8)',   // green-500 (high)
                    'rgba(234, 179, 8, 0.8)',   // yellow-500 (medium)
                    'rgba(239, 68, 68, 0.8)'    // red-500 (low)
                ]
            }]
        },
        options: {
            plugins: {
                legend: {
                    labels: { color: isDark ? '#f9fafb' : '#111827' }
                }
            }
        }
    });
}

Top/Bottom Performers

Top 10 High-Quality Memories

Criteria: Highest quality_score (0.9-1.0) Use Case: Identify most valuable memories, pin for quick access

Example:

1. FastAPI async patterns (0.95) - 24 accesses
2. Python memory optimization (0.92) - 18 accesses
3. Database indexing strategies (0.90) - 15 accesses
...

Bottom 10 Low-Quality Memories

Criteria: Lowest quality_score (0.0-0.3) Use Case: Candidates for deletion, identify noise

Example:

1. test memory (0.12) - 0 accesses
2. temporary note (0.15) - 1 access
3. debugging output (0.18) - 0 accesses
...

Actions:

  • Review: Read memory to verify low quality
  • Delete: Remove if truly unhelpful
  • Rate: Manual rating if AI misjudged

Settings Panel

Quality System Configuration

Toggles:

  • Enable/disable quality system
  • Enable/disable quality-boosted search
  • Quality boost weight slider (0.0-1.0)

Provider Selection:

  • Local (ONNX) - Default
  • Groq API - Opt-in
  • Gemini API - Opt-in
  • Auto (all tiers) - Hybrid
  • None (implicit only) - Disable AI

Retention Policy:

  • High quality retention (days)
  • Medium quality retention (days)
  • Low quality min/max (days)

Example:

<div class="settings-panel">
  <h3>Quality System</h3>
  
  <label>
    <input type="checkbox" checked> Enable Quality System
  </label>
  
  <label>
    AI Provider:
    <select>
      <option value="local" selected>Local (ONNX)</option>
      <option value="groq">Groq API</option>
      <option value="gemini">Gemini API</option>
      <option value="auto">Auto (All Tiers)</option>
      <option value="none">None (Implicit Only)</option>
    </select>
  </label>
  
  <label>
    <input type="checkbox"> Enable Quality-Boosted Search
  </label>
  
  <label>
    Quality Boost Weight: <span class="weight-value">0.3</span>
    <input type="range" min="0" max="1" step="0.1" value="0.3">
  </label>
  
  <h4>Retention Policy</h4>
  <label>
    High Quality (≥0.7): <input type="number" value="365"> days
  </label>
  <label>
    Medium Quality (0.5-0.7): <input type="number" value="180"> days
  </label>
  <label>
    Low Quality (<0.5): <input type="number" value="30"> to <input type="number" value="90"> days
  </label>
</div>

i18n Support (English + Chinese)

Quality UI Translations

English:

  • Quality: "Quality Score"
  • High: "High Quality"
  • Medium: "Medium Quality"
  • Low: "Low Quality"
  • Provider: "Quality Provider"
  • Distribution: "Quality Distribution"

Chinese (简体中文):

  • Quality: "质量分数"
  • High: "高质量"
  • Medium: "中等质量"
  • Low: "低质量"
  • Provider: "质量提供者"
  • Distribution: "质量分布"

Implementation:

const i18n = {
  en: {
    quality_score: "Quality Score",
    high_quality: "High Quality",
    quality_provider: "Quality Provider"
  },
  zh: {
    quality_score: "质量分数",
    high_quality: "高质量",
    quality_provider: "质量提供者"
  }
};

function t(key) {
  const lang = localStorage.getItem('language') || 'en';
  return i18n[lang][key] || key;
}

Performance Benchmarks

Page Load Times

Page Load Time Notes
Dashboard 25ms Memory list + quality badges
Search <100ms Semantic + quality boost
Browse 30ms Paginated memory list
Analytics 50ms Distribution + provider charts
Quality Tab 60ms Chart.js rendering

Target: <2s for all pages (✅ achieved: <100ms)

Search Performance

Operation Latency Notes
Semantic Search 50ms SQLite-vec embedding similarity
Quality Reranking 20ms Composite score calculation
Quality Boost Total <100ms Over-fetch + rerank + return

Target: <1s for search operations (✅ achieved: <100ms)


Mobile Responsive Design

Breakpoints

  • Desktop: ≥1024px - Full layout, sidebar visible
  • Tablet: 768px-1023px - Collapsed sidebar, quality badges smaller
  • Mobile: <768px - Stack layout, quality badges icons only

Quality Badges (Mobile)

Desktop: Full text badge 0.85 Mobile: Icon only 🟢 (colored circle)

Example:

@media (max-width: 768px) {
    .quality-badge {
        width: 12px;
        height: 12px;
        border-radius: 50%;
        font-size: 0;  /* Hide text */
    }
    
    .quality-badge::before {
        content: '';
        display: block;
    }
}

Accessibility (WCAG Compliance)

Color Contrast

Badges:

  • High (green): 4.5:1 contrast ratio ✅
  • Medium (yellow): 4.5:1 contrast ratio ✅
  • Low (red): 4.5:1 contrast ratio ✅

Dark Mode:

  • Text: 7:1 contrast ratio ✅
  • Interactive elements: 4.5:1 ✅

Keyboard Navigation

  • Tab through quality settings
  • Arrow keys for range sliders
  • Enter to toggle checkboxes

Screen Reader Support

<span class="quality-badge quality-high" aria-label="High quality score: 0.85">
  0.85
</span>

<div role="region" aria-label="Quality distribution chart">
  <canvas id="quality-chart"></canvas>
</div>

Related Documentation


Changelog

v8.45.2 (2025-12-06):

  • Dark mode form controls fix (white backgrounds resolved)
  • Global .form-control and .form-select overrides
  • Chart.js dark mode integration
  • Quality tab chart contrast improvements
  • Quality distribution chart with var(--neutral-400) backgrounds
  • Quality provider chart with dark mode-aware legend colors
  • .view-btn hover states improved

v8.45.0 (2025-12-05):

  • Quality badges on memory cards (color-coded by tier)
  • Analytics view with distribution charts
  • Provider breakdown pie chart
  • Top/bottom performers lists
  • Settings panel for quality configuration
  • i18n support (English + Chinese)

Need help? Open an issue at https://github.com/doobidoo/mcp-memory-service/issues

Clone this wiki locally