local-dev-composer 0.3.0

Orchestrate local microservice environments on Windows without Docker or WSL

local-dev-composer (ldc)

Orchestrate local microservice environments on Windows without Docker, Podman, or WSL.

• Start a full service graph with one command
• Per-service environment isolation (same variable, different values per service)
• Dependency ordering — services start leaf-first, stop dependents-first
• Prerequisite checks with actionable fix hints (Java version, PATH commands, env vars, ports, folders)
• Live Rich terminal dashboard
• Groups — declare the minimum set of services per development scenario
• Survives restarts — reconciles live PIDs from .ldc/state.json

Install

pip install local-dev-composer

Quick start

If ldc is not recognised after install, see Installation for PATH setup options.

Create a composer.yml in your project root:

workspace:
  root: ./services

services:
  backend:
    repo: https://github.com/your-org/backend.git
    runtime: java
    install:
      command: mvn package -DskipTests -q
    start:
      command: java -jar target/backend.jar
    health_check:
      type: http
      url: http://localhost:8080/actuator/health

  frontend:
    repo: https://github.com/your-org/frontend.git
    runtime: node
    depends_on: [backend]
    install:
      command: npm install
    start:
      command: npm start
    health_check:
      type: http
      url: http://localhost:3000

See composer.example.yml for a full working example and Configuration for the complete schema reference.

Then:

ldc bootstrap                  # clone + install + start everything in one shot

Or step by step:

ldc doctor                     # check everything, get a numbered fix list
ldc clone                      # clone all repos
ldc check --fix                # verify and fix prerequisites
ldc install                    # run install commands
ldc up --group gateway-dev     # start minimum services for your task

Daily use

ldc up --group gateway-dev     # start what you need
ldc rebuild backend            # stop + reinstall + start after code changes
ldc restart gateway            # stop + start (no reinstall)
ldc status                     # service table with PIDs and health
ldc logs gateway -f            # follow a service log
ldc down                       # stop everything

See Commands for all commands and options.

Requirements

• Python 3.9+
• Git for Windows
• Windows
• No Docker, no WSL

Documentation

Full documentation is available on GitHub:

• Installation
• Configuration
• Commands
• Groups
• Environment variables
• Prerequisites
• Health checks
• State & logs
• Architecture
• Testing

Source & contributing

https://github.com/sbugera/local-dev-composer