
# Stack Detection

When you add a project to DevKeepr, it scans the project root for known files and configuration: `composer.json`, `package.json`, `pubspec.yaml`, Dockerfiles, Xcode projects, and dozens more. Each match activates a **detector** that teaches DevKeepr how to work with that specific technology.

A single project can match multiple detectors. A Laravel app with Livewire, Inertia, and Docker will activate all four, each contributing its own capabilities.

## What a Detector Contributes

Every detector can provide one or more of the following:

### Logo

A recognizable icon for the technology, displayed in the project sidebar and detail view. Makes it easy to tell your stacks apart at a glance.

### Hibernation

Tells DevKeepr which cleanup commands to run when the project goes to sleep and which commands to run to restore it on wake. That can include deleting dependency directories like `vendor/` or `node_modules`, but it can also include framework-specific cleanup and rebuild commands. See [Smart Hibernation](/docs/general/features/hibernation) for more.

### Log Paths

Tells DevKeepr where the framework writes its logs. For Laravel that's `storage/logs/*.log`, for Electron it's `~/Library/Logs/<app>/*.log`, and so on. This lets you browse and tail logs directly from the app.

### Quick Actions

One-click commands relevant to the stack. Laravel gives you `migrate` and `optimize`, Docker gives you `compose up` and `compose down`, and Node-based detectors pull your `package.json` scripts so every `npm run` command shows up automatically.

### IDE Open

Detectors like Xcode and Android Studio can open the project directly in the right IDE with a single click.

## How Detection Works

Detection runs once when a project is added, and again whenever DevKeepr notices structural changes. The process is simple:

1. **Scan** - Each registered detector checks for specific marker files (like `composer.json` with `laravel/framework`, or a `pubspec.yaml`)
2. **Filter** - Only detectors that match are kept
3. **Compose** - The matched detectors' capabilities are merged to form a complete profile for the project

Because detectors are composable, DevKeepr's understanding of your project grows with its complexity. A Next.js app inside a Turborepo monorepo with Docker gets the combined capabilities of all three.

## Supported Stacks

DevKeepr ships with detectors for over 50 technologies across frameworks, languages, build tools, and more.

### Frameworks

| Stack | Logo | Hibernate | Logs | Actions |
|-------|:----:|:---------:|:----:|:-------:|
| Laravel | ✓ | ✓ | ✓ | ✓ |
| Symfony | ✓ | ✓ | ✓ | ✓ |
| Django | ✓ | | | ✓ |
| Rails | | | ✓ | ✓ |
| Craft CMS | ✓ | ✓ | ✓ | ✓ |
| Statamic | ✓ | ✓ | | ✓ |
| WordPress | ✓ | | ✓ | ✓ |
| Drupal | ✓ | | ✓ | ✓ |
| Jigsaw | ✓ | ✓ | | |

### Laravel Ecosystem

| Stack | Logo | Hibernate | Logs | Actions |
|-------|:----:|:---------:|:----:|:-------:|
| Livewire | ✓ | | | |
| Inertia | ✓ | | | |
| Nova | ✓ | | | |
| Filament | ✓ | | | |
| Sail | | | | ✓ |
| NativePHP Desktop | ✓ | ✓ | ✓ | ✓ |
| NativePHP Mobile | ✓ | ✓ | | ✓ |
| PHPacker | ✓ | ✓ | | |

### JS Frameworks

| Stack | Logo | Hibernate |
|-------|:----:|:---------:|
| React | ✓ | |
| Vue | ✓ | |
| Svelte | ✓ | |
| Angular | ✓ | ✓ |
| Solid | ✓ | ✓ |
| Alpine | ✓ | |

### Meta-Frameworks

| Stack | Logo | Hibernate | Actions |
|-------|:----:|:---------:|:-------:|
| Next.js | ✓ | ✓ | |
| Nuxt | ✓ | ✓ | |
| SvelteKit | | ✓ | |
| Remix | ✓ | ✓ | |
| Astro | ✓ | ✓ | |
| Gatsby | ✓ | ✓ | ✓ |
| Hugo | ✓ | ✓ | ✓ |
| Jekyll | ✓ | ✓ | ✓ |

### Desktop & Mobile

| Stack | Logo | Hibernate | Logs | Actions | IDE |
|-------|:----:|:---------:|:----:|:-------:|:---:|
| Electron | ✓ | ✓ | ✓ | | |
| Tauri | ✓ | ✓ | ✓ | ✓ | |
| Flutter | ✓ | ✓ | | ✓ | |
| Android Studio | ✓ | ✓ | | | ✓ |
| Xcode | ✓ | ✓ | | | ✓ |

### Languages & Runtimes

| Stack | Logo | Hibernate | Actions |
|-------|:----:|:---------:|:-------:|
| Node | ✓ | ✓ | ✓ |
| Deno | ✓ | ✓ | ✓ |
| Python | ✓ | ✓ | |
| Ruby | ✓ | ✓ | |
| Go | ✓ | ✓ | ✓ |
| Rust | ✓ | ✓ | ✓ |
| .NET | ✓ | ✓ | ✓ |

### Build & Tooling

| Stack | Logo | Hibernate | Actions |
|-------|:----:|:---------:|:-------:|
| Composer | ✓ | ✓ | ✓ |
| Maven | ✓ | ✓ | ✓ |
| Turborepo | ✓ | ✓ | ✓ |
| Nx | ✓ | ✓ | ✓ |
| Docker | | ✓ | ✓ |
| Makefile | | | ✓ |
| Git | | ✓ | ✓ |
| GitHub | | | ✓ |

<!-- **Totals:** 43 logos, 40 hibernation, 10 log paths, 32 quick actions, 2 IDE integrations across 51 detectors. -->
