Skip to main content
luau2ts

luau2ts

A Luau-to-TypeScript compiler for Roblox.

Get started →Try it live
Luau in, TypeScript out
example.luau
local Animal = setmetatable({}, {})
Animal.__index = Animal

function Animal.new(name)
  local self = setmetatable({}, Animal)
  self.name = name
  return self
end

function Animal:greet()
  return "Hello, " .. self.name
end
example.ts
class Animal {
  constructor(public name: string) {}

  greet(): string {
    return `Hello, ${this.name}`;
  }
}

const yui = new Animal('Yui');
print(yui.greet());

Why?

roblox-ts compiles TypeScript to Luau. luau2ts is the mirror: it compiles Luau to TypeScript. Migrate an existing Luau codebase to TS, run authored Luau through TS-native tooling, or round-trip with roblox-ts.

Install

npm install -g luau2ts
luau2ts foo.luau                          # → stdout
luau2ts foo.luau -o foo.ts                # → file
luau2ts src/ -o out/                      # → directory tree
luau2ts -p default.project.json -o out/   # → Rojo project

Compatibility

Ships two emit modes: rbxts for the @rbxts/* ecosystem, and native for runtimes that mirror Roblox's Luau API. 100% Luau conformance against the upstream test suite. Source maps included.

Read the docs →