Tidy

Tidy is a macOS-first disk space analyzer built with Electron, React, TypeScript, and Tailwind CSS. It scans a folder, shows what is using space, and lets you drill into large directories without leaving the app.

Features

• Scan any folder from a typed path or native folder picker.
• View a proportional storage bar, category legend, item sizes, and percentages.
• Expand directories lazily to inspect nested contents.
• Preview supported text and image files.
• Open items in Finder, copy paths, or delete items through macOS trash.
• Full-path hover tooltips for distribution items and rows.
• Session settings for UI scale and light/dark/system theme.

Requirements

• macOS
• Node.js with npm

Getting Started

Install dependencies:

npm install

Start the app in development:

npm start

The dev start script also patches the local Electron development bundle display name so the Dock/menu label appears as Tidy instead of Electron.

Scripts

npm start

Run the Electron Forge development app.

npm run typecheck

Run TypeScript without emitting files.

npm test

Run the Vitest test suite.

npm run qa:disk-fixture

Run a small disk-service fixture check against a temporary folder.

npm run package
npm run make

Package or make the Electron app with Electron Forge.

Project Structure

• src/main contains the Electron main process, window setup, IPC, and disk scanning service.
• src/preload exposes the safe renderer API through Electron context isolation.
• src/renderer contains the React app and global styles.
• src/shared contains shared IPC contracts and disk-related types.
• scripts contains development and QA helper scripts.

Notes

Tidy measures allocated disk usage by default, so sparse files do not inflate folder totals. The disk service also supports apparent file length internally.

The app is currently optimized for macOS APIs and behavior, including Finder integration, trash deletion, hidden-inset title bars, and vibrancy.