Start
Install tt in a new or existing TypeScript project.
Use create-tt to configure the compiler, TypeScript, bundler integration, and project scripts.
bunx @openload28/create-tt@next my-app
cd my-app
bun run devSupported 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 devExisting project
Run init from the package root, then check the tt source tree.
bunx @openload28/create-tt@next init
bun run tt:checkVS 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>.vsixEditor 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": trueManual 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 --runExternalCodeManual 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()] };