Devbox

One-command Docker dev environment for any project. Auto-detects 20+ types (Nuxt/Next/Vite/Python/Go/Rust/Java/Ruby/PHP/C#/Swift/Hugo), matches local language versions to Docker images, manages port conflicts, and attaches database services. All generated files (deps/cache/build artifacts) use named volumes for full host↔container isolation. Use when: setting up containerized dev environments, running projects in isolated Docker containers, or needing database dependencies.

Devbox — One-Command Docker Dev Environment

Create isolated Docker dev environments for any project with a single command.

How It Works

The scripts/devbox.sh script:

1. Auto-detects your project type (framework, language, package manager)
2. Reads your local language version (Node, Python, Go, Rust, Java, etc.)
3. Generates a docker-compose.dev.yml with the matching Docker image
4. Optionally attaches database services (PostgreSQL, MySQL, Redis, MongoDB, MinIO)

Volume 隔离策略

All generated files use named volumes, never bind-mounted to the host:

• Source code → bind mount (read/write from host)
• Dependencies → named volume (node_modules, pip, m2, gems, etc.)
• Build caches → named volume (.nuxt, .next, go-build, cargo-target, etc.)
• Package manager stores → named volume (pnpm-store, composer, nuget, etc.)

Benefits: no host/container cache collisions, native speed on macOS, cache survives container rebuilds.

Usage

After installing this skill, run the bundled script directly:

SKILL_DIR=$(clawhub list --json 2>/dev/null | python3 -c "import sys,json; print([s['folder'] for s in json.load(sys.stdin) if s.get('slug')=='docker-devbox'][0])" 2>/dev/null || echo "skills/docker-devbox")

# Run devbox
bash "$SKILL_DIR/scripts/devbox.sh" /path/to/project

# Or copy to PATH for convenience
cp "$SKILL_DIR/scripts/devbox.sh" /usr/local/bin/devbox
chmod +x /usr/local/bin/devbox
devbox /path/to/project

Quick Start

# Auto-detect project type
devbox /path/to/project

# Specify port + attach databases
devbox /path/to/project 8000 --with postgres,redis

# Force framework
devbox /path/to/project --framework java-spring

Supported Project Types

Type	Detection	Default Port	Docker Image
Nuxt 3/4	nuxt.config.*	3000	node:{ver}-bookworm
Next.js	next.config.*	3000	node:{ver}-bookworm
Vue + Vite	vite.config.* + vue	5173	node:{ver}-bookworm
React + Vite	vite.config.* + react	5173	node:{ver}-bookworm
Svelte	svelte.config.*	5173	node:{ver}-bookworm
VitePress	docs/.vitepress/	5173	node:{ver}-bookworm
Node.js backend	package.json	3000	node:{ver}-bookworm
Python FastAPI	requirements.txt + fastapi	8000	python:{ver}-slim
Python Django	manage.py	8000	python:{ver}-slim
Python Flask	requirements.txt + flask	5000	python:{ver}-slim
Go	go.mod	8080	golang:{ver}
Rust	Cargo.toml	8080	rust:{ver}
Java (Spring Boot)	pom.xml + spring-boot	8080	eclipse-temurin:{ver}-jdk
Java (Maven)	pom.xml	8080	eclipse-temurin:{ver}-jdk
Java (Gradle)	build.gradle / .kts	8080	eclipse-temurin:{ver}-jdk
Kotlin	*.kt (no build.gradle)	8080	eclipse-temurin:21-jdk
Ruby on Rails	Gemfile + rails	3000	ruby:{ver}-slim
Ruby Sinatra	Gemfile	4567	ruby:{ver}-slim
PHP Laravel	composer.json + laravel	5000	php:{ver}-cli
PHP	composer.json	8000	php:{ver}-cli
C# / .NET	*.csproj / *.sln	5000	dotnet/sdk:{ver}
Swift	Package.swift	8080	swift:{ver}
Hugo	hugo.toml	1313	klakegg/hugo:ext-alpine
Static HTML	*.html	80	nginx:alpine

Attach Database Services

devbox ./app --with postgres,redis

Service	Image	Port
postgres / pg	postgres:16-alpine	5432
mysql	mysql:8-alpine	3306
redis	redis:7-alpine	6379
mongo	mongo:7	27017
minio	minio/minio	9000/9001

CLI Options

devbox <project-path> [port] [options]

Options:
  --framework <type>    Override auto-detection
  --with <services>     Comma-separated services to attach
  --env-file <path>     Environment variable file
  --use-dockerfile      Use project's existing Dockerfile
  -h, --help            Show help

Volume 隔离速查表

项目类型	命名卷
Nuxt	nm, pnpm-store, nuxt, nuxt-output
Next.js	nm, next
Vue/React/Vite/Svelte	nm, pnpm-store
Python	pip
Go	go-mod, go-cache
Rust	cargo-registry, cargo-git, cargo-target
Java Maven	m2
Java Gradle	gradle
Ruby	gems
PHP	composer
.NET	nuget
Swift	swift

Included Files

scripts/devbox.sh          — Main script (auto-detect + generate compose)
scripts/create-dev-env.sh  — Backward-compatible wrapper
references/docker-templates.md — Ready-to-use compose templates with volume isolation

Dependencies

Required:

• docker + docker compose — the only hard requirement

Optional (for version detection):

• node, python3, go, rustc, java, ruby, php, dotnet, swift
• pnpm / yarn / bun — Node.js package manager detection

Optional (for port conflict detection):

• lsof — Detects host processes using a port

Only the runtimes installed on your host are used. If a language is not installed, the script falls back to a sensible default version.