Docker Compose Watch Mode (2025 GA)

docker-watch-mode-2025

Docker Compose Watch mode for hot reload during local development (2025 GA). PROACTIVELY activate for: (1) docker compose watch setup, (2) watch action types (sync, rebuild, sync+restart, sync+exec), (3) configuring path filters and ignore patterns, (4) hot-reload for Node/Python/Go/Rust apps in ...

JosiahSiegel/claude-plugin-marketplace·0installs58stars

SKILL.md

Full skill instructions

Docker Compose Watch Mode (2025 GA)

Docker Compose Watch enables automatic hot reload during local development by synchronizing file changes instantly without manual container restarts.

Three Watch Actions

1. sync - Hot Reload

For frameworks with hot reload (React, Next.js, Node.js, Flask). Copies changed files directly into running container.

2. rebuild - Compilation

For compiled languages (Go, Rust, Java) or dependency changes. Rebuilds image and recreates container when files change.

3. sync+restart - Config Changes

For configuration files requiring restart. Syncs files and restarts container.

Core Procedure

Confirm the app already starts with docker compose up before adding watch rules.
Prefer sync for source directories when the runtime already reloads files.
Use rebuild for dependency manifests, Dockerfiles, compiled artifacts, or base-image changes.
Use sync+restart for configuration files that are read only at process startup.
Add narrow ignore rules for dependency folders, build outputs, VCS folders, caches, secrets, and generated files.
Run docker compose up --watch and verify both fast source edits and dependency changes.

Usage

services:
  frontend:
    build: ./frontend
    develop:
      watch:
        - action: sync
          path: ./frontend/src
          target: /app/src
          ignore: [node_modules/, .git/, dist/]
        - action: rebuild
          path: ./frontend/package.json

Start with: docker compose up --watch.

Troubleshooting Checklist

Change not detected: verify the watched path is relative to the Compose file and not excluded by ignore.
Hot reload not firing: confirm the application inside the container has its own watcher enabled.
Container restarts too often: split source sync from manifest rebuild rules.
File ownership issues: prefer named volumes for dependency directories and sync only application code.
Slow sync: narrow watched paths and exclude build outputs or large generated folders.

References

Use docker compose watch --help and Docker's Compose Watch documentation for the current action set and CLI flags. Pair this skill with compose-patterns-2025 when watch rules interact with service dependencies, profiles, networks, or volumes.

Benefits

Better performance than broad bind mounts
Fewer host/container file permission issues
Intelligent syncing with rebuild capability
Works across supported Docker Desktop and Compose platforms

Install skill

Copy and run in your terminal

npx -y skills add https://github.com/JosiahSiegel/claude-plugin-marketplace --skill docker-watch-mode-2025

View on GitHub

plugins/azure-to-docker-master/skills/docker-watch-mode-2025/SKILL.md

tailwindcss-advanced-layouts
Tailwind CSS advanced layout techniques including CSS Grid and Flexbox patterns. PROACTIVELY activate for: (1) building complex layouts with CSS Grid, (2) grid-template-areas via Tailwind v4 arbitrary values, (3) responsive grid (grid-cols-*, auto-fit, minmax), (4) Flexbox patterns (flex-1, flex-...
8.1K installs
tailwindcss-animations
Tailwind CSS animations and transitions including built-in utilities and custom keyframes. PROACTIVELY activate for: (1) animate-* utilities (spin, ping, pulse, bounce), (2) custom @keyframes via @theme animate, (3) transition utilities (transition, duration, ease), (4) transforms (scale, rotate,...
2.4K installs
adf-validation-rules
ADF activity nesting rules, limits, and validation gotchas. PROACTIVELY activate for: (1) ADF activity nesting rules (ForEach inside If, Switch, Until), (2) ForEach limitations (no nested ForEach, item limits), (3) pipeline validation errors and ARM-template build failures, (4) linked service aut...
0 installs
fal-text-to-image
Complete fal.ai text-to-image system. PROACTIVELY activate for: (1) FLUX.1/2 Pro/Dev/Schnell generation, (2) SDXL and Fast SDXL, (3) Image size presets (square_hd, landscape_16_9), (4) Guidance scale and inference steps, (5) LoRA model application, (6) Seed for reproducibility, (7) Batch generati...
0 installs