Quick Start

From zero to a running local stack in under 5 minutes.

Prerequisites

Installation

npm (recommended)

terminal
npm install -g tdk-cli

Homebrew (macOS / Linux)

terminal
brew install tdk-cli

GitHub Releases

Binaries ship with each release from the TDK Landscape organization. Join the waitlist to get the download link on launch day.

Verify installation

terminal
tdk --version
# tdk-cli v1.0.0

Create your first service

1 — Create a new project

terminal
mkdir my-service
cd my-service
tdk init

2 — Edit service.json

service.json
{
  "appName": "my-backend",
  "appType": "backend",
  "port": 3000,
  "features": ["typescript", "bun"],
  "stack": "api"
}

3 — Generate configs

terminal
tdk generate

This writes 10 configuration files into the .autogenerated/ folder.

4 — Run the stack

terminal
tdk up

Success

Your service is now running locally. Visit http://localhost:3000 — and every new teammate who clones the repo gets the same result in minutes, not weeks.

Next steps