Repository navigation
18 Dashboard UI Guide
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
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 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)
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>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
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)
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-controland.form-selectdark mode overrides - Chart.js dynamic color configuration
- Quality distribution chart with
var(--neutral-400)backgrounds - Quality provider chart with dark mode-aware legend
/* 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);
}// 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' }
}
}
}
});
}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
...
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
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>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;
}| 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)
| 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)
- Desktop: ≥1024px - Full layout, sidebar visible
- Tablet: 768px-1023px - Collapsed sidebar, quality badges smaller
- Mobile: <768px - Stack layout, quality badges icons only
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;
}
}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 ✅
- Tab through quality settings
- Arrow keys for range sliders
- Enter to toggle checkboxes
<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>- Memory Quality System Guide - Quality scoring overview, configuration
- Web Dashboard Guide - General dashboard usage, all tabs
- Quality + Hooks Integration - Hooks quality scoring
- Troubleshooting - Common issues, solutions
v8.45.2 (2025-12-06):
- Dark mode form controls fix (white backgrounds resolved)
- Global
.form-controland.form-selectoverrides - 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-btnhover 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