Documentation

Learn how to run your microservices locally without Kubernetes and give every new team member a running system on day one.

What is TDK CLI?

TDK CLI is a Kubernetes-free microservice development tool. It runs 5-100+ services locally using only Docker and Tilt with zero cluster tax and no K8s knowledge required. Our ERP system demonstrates this with 100 microservices across 7 business domains. Onboarding a new developer becomes: clone, tdk up, code.

Write one service.json file per service, and TDK automatically generates 12-17 files per service and 40+ stack-wide artifacts:

  • Dockerfile with optimized L1-L4 golden layering
  • Vite and TypeScript configuration per app type
  • nginx reverse proxy rules and Traefik routes
  • Environment files and .npmrc wired to the local registry
  • Tiltfile for local orchestration
  • C4 architecture diagrams, dependency manifest and AGENTS.md

Why it matters for the business

Every new developer typically loses one to two weeks waiting for environment setup, credentials and specs. Hire five developers at once (the standard onboarding routine) and payroll idles. TDK compresses that to minutes, on hardware the company already owns. See the full story.

Key capabilities

Manifest-driven

Single source of truth with simple JSON configuration.

Docker only

No Kubernetes required for local development.

Auto-generation

12-17 files per service generated from one manifest.

Golden images

Production-ready Docker layering, L1 through L4.

Auto-discovery

Finds services in your directory structure automatically.

Built on Tilt

9.4k GitHub stars. Battle-tested stability.