zenlight-support Svelte Themes

Zenlight Support

A feather-light, Zen-driven dashboard that brings clarity to chaos and total mastery to Windows services.

#golang#svelte#wails#tailwindcss4#windows#window-service#desktop#window-application
Demo Download
App Logo

ZenLight Support

"More than a watcher, it’s a state of mind."
A feather-light, Zen-driven dashboard that brings clarity to chaos and total mastery to Windows services.

✨ Overview

Provide a seamless dashboard for developers and system admins to monitor status, track resources (CPU/RAM), and control critical services. Default configuration supports monitoring POS services, but can be adapted for any Windows service.

Key Features

Feature Description
⚡ Real-time Monitoring Live status updates (Running, Stopped, Paused) with sub-second latency.
📊 Resource Tracking Visual graphs for CPU usage (%) and Memory consumption (MB).
🎮 Service Control Start, Stop, and Restart services directly from the UI.
📦 Smart Installation Install and update service executables/files with one click.
⚙️ Configurable Simple YAML configuration for managing multiple services.
🔔 System Tray (Coming Soon) Background operation and status notifications.

📸 Screenshots

Real-time Monitoring Configuration & Settings
Main Dashboard Settings
Service Installer OTA Updates
Install Service Update OTA

🏗️ Architecture

Built on the Clean Architecture principle, ensuring separation of concerns and maintainability.

  • Frontend: Svelte 5 + TailwindCSS for a high-performance, reactive UI.
  • Backend: Go + Wails for native Windows API interaction.
  • Bridge: Async communication via Wails runtime events (services-update).
zenlight-support/
├── internal/
│   ├── app/        # App lifecycle & Watcher logic
│   ├── config/     # Config loader (YAML)
│   ├── domain/     # Interfaces & DTOs
│   └── service/    # Windows SCM implementation
├── frontend/src/   # Svelte 5 UI Components
├── main.go         # Entry point
└── wails.json      # Wails config

⚙️ Installation and Setup

Prerequisites

  • Go (v1.25+)
  • Node.js (LTS)
  • Wails CLI: go install github.com/wailsapp/wails/v2/cmd/wails@latest

🛠️ Steps

  1. Clone & Install Dependencies

    git clone https://github.com/zenkiet/zenlight-support.git
cd zenlight-support

# Install backend & frontend deps
make deps
cd frontend && pnpm install

  2. Run in Development Mode

    wails dev

  3. Build for Production

    wails build
# Output: ./build/bin/zenlight-support.exe

🚀 Usage Guide

Configuration (config.yaml)

The app auto-generates this file on first run.

services:
  - id: "550e8400-e29b-41d4-a716-446655440000" # Unique ID
    name: "Payment Gateway Service"           # Display Name
    serviceName: "PaymentSvc"                 # Actual Windows Service Name
    path: "C:\\Services\\Payment\\app.exe"    # Executable Path
    installable: true                         # Allow file updates

Dashboard Controls

  • Status Cards: (🟢 Running, 🔴 Stopped, 🟡 Pending).
  • Play/Stop: Toggle service state.
  • Metrics: Hover over cards to see detailed CPU/RAM history.

🔌 API / Key Functions

Backend (Go)

Function Description
Startup(ctx) Initializes Service Manager connection.
Start/StopService(id) Controls specific service state.
InstallService(id, files) Updates binary files and restarts service.
GetConfig() Returns the current loaded configuration.

Frontend Events

Event Payload Description
services-update map[string]Status Real-time status stream (1Hz).

🐞 Troubleshooting

❌ Service Not Found / Error Fetching State
  • Cause: serviceName in config.yaml doesn't match the actual Windows Service name.
  • Fix: Check services.msc for the exact Service Name (not Display Name) and update config.
🚫 Permission Denied
  • Cause: Controlling Windows services requires Administrator privileges.
  • Fix: Run the application or terminal as Administrator.
📉 Metrics Not Showing
  • Cause: The service might be running but the process ID (PID) cannot be retrieved, or monitoring is blocked.
  • Fix: Ensure the service is actually running and you have permissions to query its process information.

🤝 Contributing

Contributions are welcome! Please open issues or pull requests for bug fixes, features, or improvements.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

If this project helped you, please consider supporting its development

Star the repository ⭐
Share it with your network 📢

Made with ❤️ by ZenKiet

Top categories

tailwinddaisyuiadmin templatepopupmdsvexportfolioblogformecommerceuicarouselauthdarkseoimagerouting
Loading Svelte Themes