Terrastruct logo
Products
Resources
PricingExamplesAbout
Log in
tala icon

TALA

The layout engine that supercharges D2

TALA (Terrastruct's AutoLayout Approach), is a diagram layout engine built from scratch with zero dependencies for its algorithms. It's developed in-house at Terrastruct, designed specifically for software architecture diagrams.

What does it mean to be designed for software architecture diagrams?

  • Orthogonal pathing is more appropriate for software architecture diagrams than squiggly lines.
  • Shape placements minimize distance to each other in an unconstrained way.
  • Containers (shape nested in another shape) is a first-class consideration at every stage of the layout, as it commonly appears in software architecture diagrams.
  • Clusters (e.g. multiple shapes connected to one), trees, and hierarchies are automatically identified based on the structure of the diagram, and laid out specifically as subsections of the diagram. This means you can blend hierarchical and non-hierarchical structures in the same diagram, a frequent occurence.
  • Icons are first-class, and are placed dynamically to not interfere with labels or other obstructions.

These are all in contrast to popular diagram layout engines used in other tools. In those, either the whole diagram is hierarchical or none of it is, which is rarely what a software architecture diagram looks like. Connection paths are unnaturally squiggly. Containers are an afterthought or shim -- as a result, the layouts become suboptimal when containers are part of the equation.

TALA also has a number of optimizations that are not specific to software architecture diagrams. For example, it looks at label positioning, and will try to place labels somewhere where it doesn't clash into another label or another shape border or line.

You can see some samples here. To compare the results of TALA versus other layout algorithms, visit https://text-to-diagram.com.

TALA is constantly improving -- getting faster, producing better layouts, and supporting more types of layouts. Expect frequent updates/releases. If you find any bugs or have feature requests, please file them as issues on Github.

Usage

TALA powers all diagrams on Terrastruct. If you're just using the web app, you're already using TALA. The rest of this section applies to its usage in diagramming with D2 outside the web app (e.g. offline, locally).

You can install TALA by following instructions on Github. It's free to try and evaluate, but you'll need a license key that comes with your Terrastruct subscription to run it without restrictions.

Alternatively, if you do not want to create a Terrastruct account and just want to purchase a copy of TALA that you can use forever, offline, with access to updates for 12 months, you can purchase a personal license here and you'll receive a license key in the email.
Buy standalone Personal TALA license

Terrastruct monetizes by charging income-generating, for-profit businesses. If that is not you, e.g. student, researcher, non-profit, open-source maintainer, etc, please email us for a free license at info@terrastruct.com using an email that confirms affiliation.

Download the TALA user manual
Download PDF

Licenses

There are two types of licenses, Personal and Enterprise. There are two differences:

  1. IP assignment. Diagrams made on a Personal license belong to the creator. Diagrams made on an Enterprise license is automatically assigned IP to the purchasing entity.
  2. Enterprise licenses can be revoked by the company. This is used for when an employee departs and should no longer have access to company-internal diagrams and assets.

To be clear, these licenses only apply to usage of Terrastruct and TALA. D2 itself is FOSS (free and open-source software), governed by a different, open license (Mozilla Public License 2.0).

tala icon

Your's forever after 12 months

When your Terrastruct subscription ends, you will no longer have access to updates or the web app. But D2 will always live on in open-source as a growing go-to language for software teams to make diagrams, and if your subscription has totalled 12 months, your latest copy of TALA when your subscription ended is your's to use forever. Standalone personal licenses qualify for this.

Terms and privacy policy: The complete documents can be found here: Terms of Service and Privacy Policy. You must read, understand, and agree to each to use Terrastruct and/or TALA.

Terrastruct logo
Products
PricingWeb appD2TALAPlugins
Resources
ExamplesBlogSupportTutorialsChangelogSecurity
Compare
Diagrams.netGliffyLucidChartOmnigraffleVisio
Company
About usTermsPrivacySecurity policy

© 2023 Terrastruct, Inc.

discord
instagram
spotify
linkedin
twitter
github