Tonto
Start Here

Installation

Install the Tonto VS Code extension, CLI, package manager, and documentation tooling.

Tonto can be used from VS Code, the terminal, or both.

Requirements

ToolVersion
Node.js>=20.17.0 recommended for current packages and the Next.js documentation site.
npm>=7.7.0 for workspaces and global installs.
VS Code^1.92.0 for the current extension package.

VS Code extension

Install the extension from the Visual Studio Marketplace:

Lenke.tonto

The extension contributes:

  • .tonto and .tontodiagram languages.
  • Syntax highlighting and language configuration.
  • Language-server validation and completions.
  • Commands for JSON, Tonto, gUFO, PlantUML, TPM, project initialization, and guidance generation.
  • Diagram views and an alpha .tontodiagram editor.

CLI

Install the CLI globally:

npm install -g tonto-cli

Check that the command is available:

tonto-cli --version
tonto-cli help

The CLI package exports the command tonto-cli.

Tonto Package Manager

Install TPM globally:

npm install -g tpm

Check that the command is available:

tpm --version
tpm help

TPM reads tonto.json and installs Git-based ontology dependencies into tonto_dependencies.

Documentation package

This documentation is a statically exported Next.js application inside the Tonto monorepo.

From the repository root:

npm install
npm run docs:dev
npm run docs:check

The production export is written to:

packages/tonto-documentation/out