How thedogecraft/sparkle works
Sparkle is a Windows desktop optimizer. Users navigate its dashboard to inspect system information, then choose tools to apply/revert tweaks, debloat, clean files, manage DNS, install apps, run utilities, or create/restore backups. The React renderer communicates with Electron’s main process through the preload IPC bridge; main-process handlers perform system operations and PowerShell execution. The README documents capabilities not represented in sampled source; their module paths are supported by the tree, but unsampled page-to-handler calls are not asserted here.
Main entry points: App.tsx App router · main/index.ts Main process · tweakHandler.ts Tweak engine · preload/index.ts IPC bridge
Components 25
Desktop interface
- App router
src/renderer/src/App.tsx - System dashboard
src/renderer/src/pages/Home.tsx - Tweak controls
src/renderer/src/pages/Tweaks.tsx - Debloat controls
src/renderer/src/pages/Debloat.tsx - Cleaner controls
src/renderer/src/pages/Clean.tsx - Backup controls
src/renderer/src/pages/Backup.tsx - System utilities
src/renderer/src/pages/Utilities.tsx - DNS controls
src/renderer/src/pages/DNS.tsx - App installer
src/renderer/src/pages/Apps.tsx - Settings
src/renderer/src/pages/Settings.tsx - Update manager
src/renderer/src/components/updatemanager.tsx
Electron runtime
- IPC bridge
src/preload/index.ts - Main process
src/main/index.ts - PowerShell runner
src/main/powershell.ts - Auto updater
src/main/updates.ts
Optimization tools
- System information
src/main/system.ts - Tweak engine
src/main/tweakHandler.ts - GPU detection
src/main/gpu.ts - Debloat engine
src/main/debloat.ts
PC maintenance
- Cleaner engine
src/main/cleaner.ts - Restore points
src/main/backup.ts - DNS manager
src/main/dnsHandler.ts
Other components
- Windows user
- Windows system
- Winget / Chocolatey
Connections 33
- Windows user → App router: uses
- App router → System dashboard: routes
- App router → Tweak controls: routes
- App router → Debloat controls: routes
- App router → Cleaner controls: routes
- App router → Backup controls: routes
- App router → System utilities: routes
- App router → DNS controls: routes
- App router → App installer: routes
- App router → Settings: routes
- App router → Update manager: renders
- App router → IPC bridge: IPC requests
- IPC bridge → Main process: dispatches IPC
- Main process → System information: registers handlers
- Main process → Tweak engine: registers handlers
- Main process → Debloat engine: registers handlers
- Main process → Cleaner engine: registers handlers
- Main process → Restore points: registers handlers
- Main process → DNS manager: registers handlers
- Main process → Auto updater: initializes
- App installer → IPC bridge: checks Winget
- App installer → Winget / Chocolatey: requests installs
- Tweak engine → GPU detection: detects GPU
- Tweak engine → PowerShell runner: runs scripts
- DNS manager → PowerShell runner: runs scripts
- System information → Windows system: reads system data
- Tweak engine → Windows system: applies tweaks
- Debloat engine → Windows system: debloats
- Cleaner engine → Windows system: cleans files
- Restore points → Windows system: creates / restores
- DNS manager → Windows system: configures DNS
- Update manager → IPC bridge: requests update
- Auto updater → Windows system: downloads update