BETA Sandbox is a public preview. Tour replays real TDK CLI v1.1.0 output captured from an isolated docker container.

Interactive playground

Spin up a microservice stack,
before you write a line of code.

Drive the real TDK CLI below, frame by frame, with output captured from a live docker container. Then launch your own sandbox and repeat it for real — untouched by Kubernetes, in minutes.

The terminal

Every keystroke is real output from an isolated container.

No mockups, no screenshots. This transcript was captured live from TDK CLI v1.1.0 running in a fresh docker container — the exact commands from the quick start.

tdk · sandbox · pre-alpha idle
$
step 1/7 · press step to advance
Stack contracts Tiltfile / TILT_TECH_STACK.star / dependency-manifest.json / docs/architecture.c4 / AGENTS.md
open 

            

          

        

      

    


    
    

      

        
What you can do in here

        
Five moves. One command each.


        

          

            init
            
Scaffold a project

            
tdk project --yes builds the full PSR skeleton — .tdk/project.json, the Tilt build files, stack manifests, and a vendored copy of the TDK extension so tdk up runs offline without depending on a private repo.

            

          

          

            codegen
            
Generate services

            
One command writes 6 files per service — Dockerfile, Bun entrypoint, tests, tsconfig, manifest — already wired to the stack.

          

          

            boot order
            
Wire dependencies

            
internalDependencies drives Tilt boot order. API waits for the database.

          

          

            gate
            
Validate configs

            
tdk project --check lints layouts, ports and dependencies before a single container starts.

            
āœ“ Project configuration is valid

          

          

            run
            
Boot without Tilt or boot with it

            
Generated services are plain Bun + Hono — bun run src/index.ts serves /health immediately. Prefer orchestration? tdk up pre-alpha hands the stack to Tilt with zero config.

          

        

      

    


    
    

      

        
Read the transcript

        
One manifest, six generated files, a stack that boots from localhost:3000 — and every teammate who clones the repo gets the identical result in minutes, not weeks.


        

          

            
Install

            
One-line installer, auto-detects macOS, Linux, Intel and Arm.

            
$ curl -fsSL https://tdk-landscape.github.io/install.sh | sh
$ tdk --version
1.1.0

          

          

            
Docker sandbox

            
Zero-install path: run the CLI from docker compose.

            
$ git clone https://github.com/tdk-landscape/tdk-docker-compose-example.git
$ cd tdk-docker-compose-example
$ docker compose run --rm tdk tdk project --yes

          

          

            
Bun run

            
The fastest way into a running service.

            
$ cd services/pre-alpha/api
$ bun install
$ bun run src/index.ts
šŸš€ api running on http://localhost:3000

          

          

            
Tilt up

            
Full orchestration, boot order from dependencies.

            
$ tdk up pre-alpha
Starting 2 services from stack "pre-alpha":
  - api
  - database
šŸ“Š Tilt UI: http://localhost:10350

          

        

      

    


    
    

      

        

          
Launch yours

          
Your sandbox is one command away.

          
Spin up an isolated container, drive the CLI inside it, and tear it down when you are done — your host stays spotless.

          

            docker run --rm -it --entrypoint sh tdk-landscape/tdk-cli-releases:latest
            
          

          

            git clone https://github.com/tdk-landscape/tdk-docker-compose-example.git && cd tdk-docker-compose-example && docker compose run --rm tdk tdk --version
            
          

          

            
            Read the quick start