README

TDL is a modern, text-based language for defining software architecture diagrams. It is optimized for:

  1. LLM Generation: High token efficiency means faster and cheaper generation by AI agents

  2. Human Readability: Clean, indentation-based syntax inspired by Python and YAML

  3. Professional Output: Renders into beautiful, presentation-ready diagrams

Example

@arch Microservices Architecture

[nodes]
  gateway:API Gateway|icon:aws-api-gateway
  auth:Auth Service|icon:gilbarbara-auth0
  db:User Database|cyl|icon:devicon-postgresql

[edges]
  gateway->auth:validates
  auth->db:queries

[groups]
  backend:Backend Services
    auth
    db
Rendered diagram

Documentation

Implementations

Last updated