Roblox TypeScript Developer

Workflow for Roblox projects authored in TypeScript and compiled to Luau with roblox-ts. The build pipeline, package ecosystem, and interop surface differ from plain Luau. This skill covers the compiler, @rbxts/* packages, and the interop surface; framework layers built on top of roblox-ts, such as Flamework, are out of scope.

Build pipeline

The canonical flow is .ts source → rbxtsc (the roblox-ts compiler) → .lua under out/ → rojo serve/rojo build → Studio.

• Compiler: roblox-ts (npm), binary rbxtsc.
• Types: @rbxts/types, auto-published against the Roblox API.
• Config: tsconfig.json with compilerOptions targeting roblox-ts.
• Rojo maps the compiled out/ directory into the place file, so default.project.json points at compiled output, not the .ts source.

Edit .ts source; out/ is its build artifact, patched only in an emergency the user names.

Project detection

Recognize a roblox-ts project by rbxtsc in package.json scripts, a tsconfig.json with roblox-ts settings, @rbxts/* packages, and an out/ directory mapped by default.project.json.