A lightweight desktop application for managing database services on Windows.

• ✨ Modern Fluent Design UI - Windows 11 inspired dark mode with acrylic effects
• 🎨 Vibrant Color-Coded Stats - Real-time visual indicators (blue/green/orange)
• Start, Stop, and Restart database services
• Real-time service status monitoring with live status badges
• Hierarchical service filtering and search Minimal resource usage (<50MB RAM)
• Simple and intuitive interface with keyboard shortcuts
• Support for all popular databases

Minimum Resource Requirements:

• RAM: At least 30MB available (WebView2 requires ~400MB alone)
• CPU: Modern processor (2010+)
• Storage: ~400MB for application and WebView2 runtime
• OS: Windows 10/11 with WebView2 runtime

⚠️ Caution for Lower-End Systems:

• On systems with <2GB RAM, this application may still consume noticeable resources
• WebView2 runtime is mandatory and uses a baseline of 25-30MB
• Running alongside other heavy applications may cause performance degradation
• If system has <1GB available RAM, consider closing other applications first
• On older processors (pre-2010), UI rendering may be slower

GPU Considerations:

• Acrylic effects use GPU resources; disable them in main.go if you have an older/integrated GPU
• Systems with no dedicated GPU may experience slight lag with visual effects enabled

• Service status updates are cached and may not reflect real-time changes immediately
• Search filtering is debounced for performance (slight delay before results update)
• Acrylic/visual effects are enabled by default; disable them in main.go for even lower GPU usage
• Some UI transitions are optimized away for faster load times

Note: These optimizations prioritize system efficiency. If you need real-time service status updates, you may want to reduce the cache TTL in app/service_manager.go (currently set to 30 seconds).

• PostgreSQL - Open-source relational database
• MySQL - Popular open-source database
• MariaDB - MySQL fork with enhanced features
• Microsoft SQL Server - Enterprise database system (includes Agent, Browser, SSIS, SSRS, and more)
• Oracle Database - Enterprise-grade RDBMS
• IBM DB2 - Enterprise database platform
• Firebird - Open-source SQL database
• SQLite - Lightweight embedded database

• MongoDB - Document-oriented database
• Cassandra - Distributed wide-column store
• CouchDB - Document-oriented database
• Neo4j - Graph database platform

• Redis - In-memory data structure store
• Memcached - Distributed memory caching system

• Elasticsearch - Search and analytics engine
• InfluxDB - Time-series database

• RabbitMQ - Message broker (often used with databases)

Before building this application, you need to install:

1. Go 1.21+ - Download from https://go.dev/dl/
2. Node.js 16+ - Already installed (v25.0.0 detected)
3. Wails CLI - Install with: go install github.com/wailsapp/wails/v2/cmd/wails@latest
4. Windows Build Tools - Required for Windows development

Download and install Go from https://go.dev/dl/

After installation, verify with:

go version

Once Go is installed, run:

go install github.com/wailsapp/wails/v2/cmd/wails@latest

Make sure your Go bin directory is in your PATH. The default location is:

• Windows: %USERPROFILE%\go\bin

Install Go dependencies:

go mod download

Install frontend dependencies:

cd frontend
npm install
cd ..

Run in development mode:

wails dev

Build the production executable:

wails build

The executable will be in the build/bin directory.

service-db-dashboard/
├── app/                    # Go backend code
│   ├── models.go          # Data models
│   ├── errors.go          # Error types
│   ├── os_adapter.go      # Windows Service Control Manager adapter
│   ├── detector.go        # Service detection logic
│   ├── cache.go           # Service cache
│   └── service_manager.go # Main service manager
├── frontend/              # React TypeScript frontend
│   ├── src/
│   │   ├── components/    # React components
│   │   ├── types/         # TypeScript types
│   │   └── wailsjs/       # Auto-generated Wails bindings
│   └── package.json
├── main.go                # Application entry point
├── wails.json             # Wails configuration
└── go.mod                 # Go module definition

1. Run the application as Administrator (required for service management)
2. The dashboard will automatically detect all installed database services
3. Use the Start, Stop, and Restart buttons to manage services
4. Service status updates automatically every 5 seconds

The application automatically detects database services by scanning Windows Services for known patterns:

• PostgreSQL services (postgresql, postgres)
• MySQL services (mysql)
• MariaDB services (mariadb)
• SQL Server services - Detects ALL related services:
  • Database Engine (mssql, sqlserver, mssqlserver)
  • SQL Server Agent (sqlagent, sqlserveragent)
  • SQL Server Browser (sqlbrowser)
  • SQL Server VSS Writer (sqlwriter)
  • SQL Server CEIP/Telemetry (sqlceip, sqltelemetry)
  • Integration Services - SSIS (msdtsserver)
  • FullText Search (msftesql)
  • Reporting Services - SSRS (reportserver)
• MongoDB services (mongodb, mongo)
• Redis services (redis)
• Elasticsearch services (elasticsearch, elastic)
• And many more...

Note: For detailed information about SQL Server services, see SQL_SERVER_SERVICES.md.

If you have a database service that isn't detected, it may be using a non-standard service name.

• Framework: Wails v2
• Backend: Go with Windows Service Control Manager APIs
• Frontend: React 18 + TypeScript 5 + Vite
• Design System: Windows 11 Fluent Design with CSS variables
• UI Features: Acrylic backgrounds, smooth animations, color-coded metrics
• Target RAM: <50MB idle usage
• Polling Interval: 5 seconds (2 seconds during operations)

The application features a modern, dark-mode interface inspired by Windows 11 Fluent Design:

• Color Palette:

  • Dark grayscale backgrounds (#121212 to #4b4b4b)
  • Bright blue accent (#2e86de) for primary actions
  • Color-coded service stats (Blue: Total, Green: Active, Orange: Inactive)

• Design Elements:

  • Acrylic material effects with blur and saturation
  • Smooth animations and transitions (100-600ms)
  • 4px standard border radius
  • Glass morphism cards and components

• Service Stats Display:

  • Fixed bottom-right corner for quick reference
  • Real-time colored indicators with glow effects
  • Hover animations and transitions