🧹 KV-Clearnup — High-Performance System Optimizer & Deep Uninstaller

A modern, lightning-fast system optimizer and thorough uninstaller for macOS & Windows, powered by Electron, React, and a compiled Go core.

Why KV-Clearnup • Features • Comparison • Architecture • Quickstart • Build • License

---

⚡ Why KV-Clearnup?

Commercial Mac cleaners are burdened by expensive annual subscriptions, aggressive background upselling, and heavy telemetry daemons. Meanwhile, basic uninstallers often miss deeply buried developer caches (Xcode DerivedData, CocoaPods, Homebrew) and residual preference files left behind by deleted applications.

KV-Clearnup couples a modern, fluid React/TypeScript frontend with an ultra-fast compiled Go backend engine, delivering instant recursive directory scans, complete residue uninstallation, and developer-first cache pruning with zero subscriptions or tracking.

📊 Competitive Matrix

Feature	🧹 KV-Clearnup	🧼 CleanMyMac X	📦 AppCleaner	🐚 BleachBit
Pricing & License	100% Free & Open-Source (MIT)	$39.95/yr Subscription	Free (Closed Source)	Free & Open Source (GPL)
Core Architecture	Electron + Compiled Go Engine	Proprietary Daemon	Native Cocoa	Python GTK
Residual App Uninstaller	✅ Deep purge (Library, Prefs, Logs)	✅ Deep purge	✅ Basic leftovers	⚠️ Cache only
Developer Cache Purge	✅ Xcode, Homebrew, npm, pnpm	⚠️ Basic caches	❌ None	⚠️ General system logs
Scanning Speed	⚡ Concurrent Go routines (<15ms)	🟡 Moderate	⚡ Fast	🟡 Python OS walk
Native Menubar Tray	✅ Dynamic Dark/Light Menubar	✅ Heavy Menubar app	❌ None	❌ None
Cross-Platform Support	✅ macOS (Universal) & Windows	❌ macOS only	❌ macOS only	✅ Linux & Windows
Telemetry & Privacy	✅ Zero telemetry / 100% local	❌ Analytics & Tracking	✅ Clean	✅ Clean

---

✨ Features

• ⚡ Flash Clean: Instantly sweep system caches, log archives, Xcode DerivedData/Simulator caches, Homebrew caches, and manage Trash with granular per-file inspection.
• 🗑️ Deep App Uninstaller: Inspect installed applications, calculate total footprint on disk, and perform complete removal along with associated caches, preferences, Application Support folders, and daemon plists.
• 🔍 Deep Clean & Disk Analyzer: High-speed recursive disk walk to identify large files, monolithic directories, and reclaim wasted gigabytes.
• 📊 Real-Time Telemetry: Live disk usage breakdown with interactive category visualization and storage health gauges.
• 🍏 Adaptive Menubar Integration: Responsive, monochrome template menubar tray icon that dynamically matches macOS light/dark modes.
• 🚀 Hardware-Optimized Binaries: Ships natively compiled Go binaries for Apple Silicon (M1/M2/M3/M4), Intel Macs, and Windows x64.

---

🏗️ Architecture

┌────────────────────────────────────────────────────────┐
│                   KV-Clearnup Desktop                  │
│             (Vite + React 18 + TailwindCSS)            │
└───────────────────────────┬────────────────────────────┘
                            │ IPC / HTTP REST (localhost:36969)
┌───────────────────────────▼────────────────────────────┐
│               Electron Main Process                    │
│      (Menubar Tray, Child Process Orchestration)       │
└───────────────────────────┬────────────────────────────┘
                            │ Spawns native daemon
┌───────────────────────────▼────────────────────────────┐
│               Compiled Go Backend Core                 │
│                                                        │
│  ┌──────────────────────┐    ┌──────────────────────┐  │
│  │ Concurrent Goroutines│    │  Residual Discovery  │  │
│  │ Fast FS Walk Engine  │    │  (Library / Prefs)   │  │
│  └──────────┬───────────┘    └──────────┬───────────┘  │
└─────────────┼───────────────────────────┼──────────────┘
              │ Direct POSIX / Win32 I/O  │
┌─────────────▼───────────────────────────▼──────────────┐
│           Host Operating System (macOS / Windows)      │
│      ~/Library/Caches, DerivedData, Registry / FS      │
└────────────────────────────────────────────────────────┘

---

🚀 Development & Quickstart

Prerequisites

• Node.js (v18+)
• Go (v1.20+)
• pnpm (recommended) or npm
• C Compiler (Xcode Command Line Tools on macOS or gcc on Windows/Linux)

1. Install Dependencies

pnpm install

2. Run in Development Mode

This concurrently starts the compiled Go backend service (port 36969) and the Vite/Electron frontend window:

./start-go.sh

---

📦 Building for Production

Create standalone distributable release packages:

macOS Universal DMG (Apple Silicon + Intel)

pnpm run build && pnpm run electron:build && npx electron-builder --mac --universal

Windows Portable Executable

pnpm run build && pnpm run electron:build && npx electron-builder --win portable --x64

Output installers are generated directly in release/:

• release/KV Clearnup-1.0.0-universal.dmg (macOS)
• release/KV Clearnup 1.0.0.exe (Windows)

---

🌟 Star History

---

📄 License

This project is licensed under the MIT License.