Disk Map

A native macOS disk explorer in development, focused on interactive treemaps and finding large files, folders, and bundles.

Explore the GitHub Pages preview

The website is an interactive prototype with fictional sample files. The native Swift app scans real folders on your Mac and can be built locally. There is no notarized public release yet.

• Feature specification
• Implementation phases
• Wireframe screens and interactions
• Native architecture and accounting

Build and run the macOS app

Requires macOS 14 or later and Swift 5.9+ (Xcode or Apple's Command Line Tools).

bash scripts/build-app.sh
open "build/Disk Map.app"

Choose a folder or volume, scan Home, or drop a folder into the window. Use the treemap, Largest Items, or Bundles & Packages to explore results. Select a package and choose Inspect Package Contents to open it. Reveal in Finder and Copy Path act on the selected item. Scans read metadata only and stay local. Development Cleanup lets you select generated folders, review their exact paths and measured sizes, then move them to Trash.

The build script uses ad-hoc signing by default for local execution. An optional DISKMAP_SIGN_IDENTITY selects an installed Developer ID identity; notarization is a separate release step. Full Disk Access can be granted manually if you want to scan protected locations.

Keyboard shortcuts: ⌘O choose location, ⌘R rescan, ⌘. cancel, ⌘F search, ⌘G next match, ⌘[ back, ⌘↑ parent, ⌘0 root, ⌘Return inspect, ⌘⇧R reveal, ⌘⌥C copy path.

Development cleanup

Scan a folder containing your projects, then open Development Cleanup in the sidebar. Select folders individually or use Select Listed, then Review Selected… → Move to Trash. Search filters the list by name or path; the review includes every selected folder, including selections hidden by search.

Recognized folders include:

• JavaScript: node_modules, framework caches (.next, .nuxt, .svelte-kit, .parcel-cache, .turbo), and build/dist alongside package.json.
• Python: __pycache__, .pytest_cache, .mypy_cache, .ruff_cache, and .venv/venv containing pyvenv.cfg.
• Swift: .build alongside Package.swift; Rust: target alongside Cargo.toml.
• .NET: bin/obj alongside a .csproj, .fsproj, or .vbproj file.
• Java: target alongside pom.xml; Gradle: build and project-local .gradle with matching Gradle project files.

These are suggestions based on folder names and project metadata. Check for local edits and stop active development tools first. Packages, Git internals, Trash, protected system paths, incomplete folders, and the scan root are excluded. Nested generated folders appear only once. Cleanup is disabled until a scan finishes, rechecks folder and ancestor identities, reports individual failures, and rescans afterward. There is no permanent-delete fallback. Moving to Trash does not free space until you empty Trash in Finder, and reported allocation is not guaranteed reclaimable space.

Native validation

Run these after implementation:

swift run disk-map-check
swift run disk-map-check --scan /path/to/a/test/folder

The core checks create and remove their own temporary fixtures, covering packages, hard links, symlinks, hidden files, permission denial, cancellation, unknown allocation, treemap geometry, cleanup classification, changed paths, failed moves, and a native Trash move followed by restoration of the disposable fixture.

Website development

Requires Python 3 and Node.js for JavaScript syntax validation; no third-party packages are needed.

python3 scripts/build-site.py
python3 -m http.server 8000 --directory dist

Open http://localhost:8000. Edit site/ for the website framing and wireframes/disk-map-ui.html for the interactive prototype. The build inserts the shared prototype into the page, so there is only one source for its behavior.

GitHub Pages

The Pages workflow builds and validates pull requests. Pushes to main also publish the dist/ artifact. The repository's Pages publishing source is GitHub Actions. Generated output is not committed.

GitHub Pages serves the static preview only; the planned native scanner is a separate macOS application.