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, so keep them distinct from Luau-authoring habits.

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 as the source of truth; do not patch generated Luau under out/ unless the user asks for an emergency generated-output patch.

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.