Getting Started
Prerequisites
Section titled “Prerequisites”- .NET 10 SDK — Download from Microsoft
- Windows 10/11 — The daemon reads Windows-specific system metrics (CPU via
PerformanceCounter, RAM viaGlobalMemoryStatusEx) - Git (optional) — To clone the repository
Projects
Section titled “Projects”LeaseGate-Lite is a multi-project .NET solution:
| Project | Description |
|---|---|
src/LeaseGateLite.Contracts | Shared DTOs and enums |
src/LeaseGateLite.Daemon | Local API daemon on localhost:5177 with real Windows system metrics |
src/LeaseGateLite.App | One-tab MAUI control panel (Windows/Android/iOS/macCatalyst) |
src/LeaseGateLite.Tray | Windows system tray companion |
tests/LeaseGateLite.Tests | 195 xUnit tests (config validation, simulation, diagnostics, redaction) |
Run the daemon
Section titled “Run the daemon”dotnet run --project src/LeaseGateLite.DaemonThe daemon starts on localhost:5177 and immediately begins collecting real system metrics (CPU via PerformanceCounter, RAM via GlobalMemoryStatusEx).
Launch the control panel
Section titled “Launch the control panel”dotnet build src/LeaseGateLite.App -f net10.0-windows10.0.19041.0dotnet run --project src/LeaseGateLite.App -f net10.0-windows10.0.19041.0The MAUI app connects to the daemon automatically and displays live status.
One-click packaging (Windows)
Section titled “One-click packaging (Windows)”Create a release artifact (portable zip + SHA256 checksum):
powershell -ExecutionPolicy Bypass -File scripts/package-v0.1.0.ps1 -Version 1.0.1Install locally from the packaged artifact:
powershell -ExecutionPolicy Bypass -File scripts/install-local.ps1 -EnableAutostartAfter installation:
- The daemon runs immediately and can start on login
- The control panel launches and connects automatically
- Balanced is the default preset; laptop-like hardware gets a Quiet recommendation in first-run setup (never forced)
Run the tests
Section titled “Run the tests”dotnet test tests/LeaseGateLite.TestsAll 195 tests use a FakeSystemMetrics provider via dependency injection for deterministic, hardware-independent verification.