# Disk Usage

The Disk Usage page gives you a breakdown of how much space your projects consume, split by technology stack. It shows what's reclaimable through hibernation (dependencies, caches, build artifacts) versus what's source code you want to keep.

![Disk Usage breakdown by category and by project](/screenshots/docs/disk-usage.webp)

## How It Works

DevKeepr already knows your projects and their stacks through [Stack Detection](/docs/general/features/stack-detection). Each detected stack contributes hibernation commands that target specific directories: `vendor/`, `node_modules/`, `.next/`, `target/`, and so on. The Disk Usage analyzer measures those directories across all your projects and groups the results by category.

Scanning runs automatically whenever project data changes, a project hibernates, or a project wakes. You can also trigger a manual refresh from the Disk Usage page.

## Categories

Reclaimable space is grouped into categories based on the detected stack:

| Category | Examples |
|----------|----------|
| PHP | `vendor/`, Composer cache, framework caches |
| Node | `node_modules/`, `.next/`, `.nuxt/`, build output |
| Rust | `target/` |
| Ruby | Bundler gems |
| Python | Virtual environments |
| Go | Build cache |
| .NET | `bin/`, `obj/` |
| Dart | Flutter build artifacts |
| Java | Maven target directories |
| Apple | Xcode derived data |

A project can appear in multiple categories. A Laravel app with Node support shows up under both PHP and Node.

## Two Ways to View

The page offers two viewing modes you can toggle between.

### By Category

The default view groups space by technology. Each category expands to show which projects contribute to it and how much. This is useful when you want to know how much total space Node dependencies take across all your projects.

### By Project

The project view flips the grouping. Each project expands to show its space broken down by category. This is useful when you want to understand where a specific project's size comes from.

## What the Numbers Mean

The summary panel shows three key numbers:

- **Total size**: combined size of all detected projects
- **Reclaimable**: space that can be freed by hibernating all projects
- **Next run**: space that will be freed when the next scheduled hibernation runs (only counts projects that are currently awake and due for hibernation)

Source code size is shown separately. This is the non-reclaimable portion: your actual code, assets, and configuration files. If source code takes up an unusually large share of a project's size, DevKeepr flags it as a hint that there might be undiscovered cleanup opportunities.

## Hibernate From Here

You don't have to leave the Disk Usage page to act on what you see. The **Hibernate Now** button triggers hibernation for all eligible projects immediately. For finer control, click through to any project to manage its [hibernation settings](/docs/general/features/hibernation) individually.

## Overview Widget

A summary of disk space reclaimed also appears on the [Overview panel](/docs/general/features/command-center#the-overview-panel), showing total reclaimed space, how much was reclaimed this month, and a donut chart of the breakdown by category.