WordPress Performance Dashboard

Real-time WordPress performance monitoring dashboard for database, plugin, and system metrics, styled like Grafana/Netdata.

Highlights

• Live metrics for response time, QPS, and memory
• Slow query and plugin impact analysis
• Admin-Ajax monitoring and recommendations
• REST API + WebSocket updates
• Docker-ready demo environment

Demo (Recommended)

Spin up the full demo stack (WordPress + MySQL + dashboard):

./demo/start-demo.sh start --with-dashboard

Access:

• WordPress: http://localhost:8090 (admin/demo_password)
• Dashboard: http://localhost:3001
• MySQL: localhost:3307 (demo_user/demo_password)

Full demo docs: demo/README.md

Local Run (Node)

npm install
cp .env.dashboard.example .env
npm start

Dashboard: http://localhost:3000

Required local configuration:

• Set DB_HOST, DB_USER, DB_PASSWORD, and DB_NAME for direct DB mode
• Or set WP_API_URL and optional WP_API_USERNAME / WP_API_PASSWORD for external WordPress mode
• Set ADMIN_TOKEN to use POST /api/demo-refresh

App start recording (800x500):

Docker

• Full stack: docker-compose -f docker-compose.full.yml up -d
• Dashboard-only: docker-compose -f docker-compose.dashboard.yml up -d

See Docker Setup Guide for details.

API (Quick Look)

• GET /api/dashboard
• GET /api/metrics
• GET /api/slow-queries
• GET /api/system-health
• POST /api/demo-refresh with x-admin-token

Full API notes: docs/

Testing

npm test

Documentation

Document	Description
Docker Setup	Docker configuration and deployment
Demo Integration	How the demo environment integrates
Error Recovery	Error handling and recovery systems
Demo Quick Start	Get the demo running in minutes
Demo Data Structure	Demo data schema and content
Demo Scripts	Management script documentation
Demo Troubleshooting	Common issues and solutions

Project Links

• Demo Environment: demo/README.md
• Task Tracking: docs/todo.md
• License: MIT