tta small language for TypeScript and TSX

Start

Install tt in a new or existing TypeScript project.

Use create-tt to configure the compiler, TypeScript, bundler integration, and project scripts.

shell
bunx @openload28/create-tt@next my-app
cd my-app
bun run dev

Supported setup

  • New projects use Vite, TypeScript, Bun, and the TypeScript 7.1 content mapper.
  • Existing projects support Vite, Rollup, Rolldown, webpack, Rspack, esbuild, and Farm.
  • Manual installs use the next channel for the latest Nightly.
  • Prebuilt compilers support Linux x64/arm64, macOS x64/arm64, and Windows x64.

New project

Create a ready-to-run Vite and TypeScript project. The generated TypeScript config resolves .tt and .ttx imports through the content mapper without sidecars.

bunx @openload28/create-tt@next my-app
cd my-app
bun run dev

Existing project

Run init from the package root, then check the tt source tree.

bunx @openload28/create-tt@next init
bun run tt:check

VS Code extension

Download tt-language-<version>.vsix and tt-typescript-preview-<version>-<platform>.vsix from the latest GitHub pre-release, then install both in VS Code.

Download from GitHub Releases ↗
code --install-extension ./tt-language-<version>.vsix
code --install-extension ./tt-typescript-preview-<version>-<platform>.vsix

Editor TypeScript (useTsgo)

Enable TypeScript 7 so the editor can resolve .tt imports from .ts and .tsx files.

// .vscode/settings.json (or user settings)
"js/ts.experimental.useTsgo": true,
"typescript.experimental.useTsgo": true

Manual compiler

Install the compiler and supported TypeScript version, declare the content mapper at the top level of tsconfig.json, and run TypeScript with external-code permission.

bun add -d @openload28/tt-lang@next typescript@7.1.0-dev.20260826.1

// tsconfig.json
{
"contentMappers": [
{ "package": "@openload28/tt-lang", "extensions": [".tt", ".ttx"] }
]
}

bunx tsc -p tsconfig.json --runExternalCode

Manual bundlers

Install the bundler plugin and add tt() first in the plugins array. Use the adapter for your bundler.

bun add -d @openload28/tt-lang@next @openload28/unplugin-tt@next typescript@7.1.0-dev.20260826.1

import tt from "@openload28/unplugin-tt/vite";
export default { plugins: [tt()] };
NextReact / .ttx →