시작
새 프로젝트나 기존 TypeScript 프로젝트에 tt을 설치합니다.
create-tt으로 컴파일러, TypeScript, 번들러 연동, 프로젝트 스크립트를 구성합니다.
shell
bunx @openload28/create-tt@next my-app
cd my-app
bun run dev지원 범위
- 새 프로젝트는 Vite, TypeScript, Bun으로 구성합니다.
- 기존 프로젝트는 Vite, Rollup, Rolldown, webpack, Rspack, esbuild, Farm을 지원합니다.
- 수동 설치는 최신 Nightly를 가리키는 next 채널을 사용합니다.
- 프리빌트 컴파일러는 Linux x64/arm64, macOS x64/arm64, Windows x64를 지원합니다.
새 프로젝트
바로 실행할 수 있는 Vite와 TypeScript 프로젝트를 만듭니다.
bunx @openload28/create-tt@next my-app
cd my-app
bun run dev기존 프로젝트
패키지 루트에서 init을 실행한 뒤 tt 소스 트리를 검사합니다.
bunx @openload28/create-tt@next init
bun run tt:checkVS Code 확장
최신 GitHub pre-release에서 tt-language-<버전>.vsix와 tt-typescript-preview-<버전>-<플랫폼>.vsix를 내려받아 VS Code에 설치합니다.
GitHub Releases에서 다운로드 ↗code --install-extension ./tt-language-<version>.vsix
code --install-extension ./tt-typescript-preview-<version>-<platform>.vsix에디터 TypeScript (useTsgo)
에디터가 .ts와 .tsx 파일에서 .tt import를 해석하도록 TypeScript 7을 활성화합니다.
// .vscode/settings.json (or user settings)
"js/ts.experimental.useTsgo": true,
"typescript.experimental.useTsgo": true컴파일러 수동 설치
컴파일러와 지원하는 TypeScript 버전을 설치한 뒤 소스 트리를 컴파일하거나 검사합니다.
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번들러 수동 설정
번들러 플러그인을 설치하고 plugins 배열 맨 앞에 tt()을 추가합니다. 사용하는 번들러에 맞는 어댑터를 선택합니다.
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()] };