Everything you need for microservice development
Without the Kubernetes complexity. Powered by Tilt + Starlark.
Configuration Generation
One service.json generates 10+ configuration files automatically.
01. TypeScript Config
Auto-generates tsconfig.json with proper paths, includes, and compiler options for backend, frontend, and libraries.
02. Vite Configuration
Generates vite.config.ts for local, Docker, and production builds with optimized settings.
03. Docker & Compose
Multi-stage Dockerfile with golden image layering. Docker Compose for service orchestration.
04. Nginx Proxy
Auto-configures nginx reverse proxy rules with Traefik integration for local development.
05. Environment Files
Generates .env files with service-specific variables, database URLs, and internal dependencies.
06. Package Manager
Auto-generates .npmrc and bunfig.toml with registry configuration for Verdaccio and npm.
07. AGENTS.md Guard
Generates AGENTS.md in .autogenerated/ folder to prevent AI agents from modifying generated files.
Development Experience
Built on Tilt with 9.4k GitHub stars for maximum productivity.
08. Hot Reload
Instant code sync with Tilt's live_update. Changes appear immediately without container rebuild.
09. Selective Startup
Start only the services you need. Run 5 services instead of 120. Perfect for large codebases.
10. Auto-Discovery
Automatically discovers all service.json files in your directory structure. Zero manual registration.
11. Manifest Synthesis
Services without manifests auto-configure from directory structure. Convention over configuration.
12. Config-Gen Resources
Each manifest gets a visible Tilt resource. See status, logs, and errors for every service individually.
13. Dependency Graph
Automatic dependency resolution with internalDependencies. Services start in correct order.
14. Stack Grouping
Group related services by stack. Start entire feature sets with one command: tdk up --stack api
Infrastructure & Deployment
Production-ready Docker images with smart layering.
15. Golden Images
4-layer Docker architecture: L1 (OS) → L2 (Runtime) → L3 (Builder) → L4 (App). Optimized caching.
16. Docker Only
Pure Docker + Tilt. No Kubernetes required for local development. Simple, fast, predictable.
17. Traefik Integration
Automatic Traefik reverse proxy configuration. Pretty URLs like user.backend.localhost.
18. API Gateway
Auto-generates API Gateway configuration for routing between services with path-based rules.
19. Local Registry
Verdaccio npm registry for local package publishing. Share libraries between services.
20. Playwright Testing
Auto-configures Playwright for E2E testing with service-specific test configurations.
21. C4 Diagrams
Auto-generates C4 architecture diagrams from your service topology. Visualize system design.
Database & State Management
Per-service database provisioning with Prisma integration.
22. Database Provisioning
Auto-creates PostgreSQL database per service. Each service gets isolated database with proper naming.
23. Prisma Integration
Auto-generates Prisma configuration with DATABASE_URL. Schema migration support built-in.
24. DB Readiness Checks
Waits for database to be ready before starting services. Prevents connection errors on startup.
25. Migration Scripts
Auto-generates database migration scripts. Run prisma migrate on service startup.
26. Persistent Volumes
Docker volumes for database persistence. Data survives container restarts during development.
27. NATS Integration
Built-in NATS JetStream configuration for event-driven microservices with pub/sub messaging.
28. Redis Support
Auto-configures Redis for caching and sessions. Shared Redis instance for all services.
Security & Operations
Enterprise-grade security with pre-flight validations.
29. Infisical Secrets
Complete Infisical integration for secret management. Machine identity, paths, and dynamic secrets.
30. Pre-Flight Validators
Validates manifests before build. Catches misconfigurations early with detailed error messages.
31. Dependency Manifest
Resolves internalDependencies automatically. Creates dependency graph for complex service trees.
32. Path Safety
Docker-safe path handling with fixed TSConfig paths. No more build failures in containers.
33. Health Checks
Built-in health check endpoints. Tilt monitors service health and restarts on failure.
34. Library Autodiscovery
Discovers @tdk/* dependencies from package.json. Auto-links local libraries for development.
35. Resource Aliases
Smart name-to-path mapping. Reference services by simple names in dependencies and commands.
And there's more...
TDK CLI is actively developed with new features added regularly.
Explore Documentation →