Azul

What Azul is

Azul is a Studio-first sync tool for Roblox projects. The Studio DataModel is the source of truth, and Azul mirrors that structure to your local filesystem so you can use editor tooling like linting, search, and refactoring.

If you already have local files, Azul can also push them back to Studio with azul build and azul push.

Key features

Bi-directional Sync

Edit scripts in Studio or your editor and keep both sides updated.

Works with existing places

No required project schema. Start from a new place or an old one.

Build & Push local files

Use build for full pushes or push for targeted updates.

Rojo compatibility

Import from existing Rojo-style projects with --rojo when needed.

Sourcemap support

Generate a Rojo-compatible sourcemap.json for tools like Luau LSP.

Quick start

1. Install the Daemon and Plugin in Installation.
2. Open a new folder locally and run azul.
3. Open your place in Studio and click Connect in the Azul plugin.
4. Start editing scripts and watch both sides stay in sync.

For full setup details, continue to Project Setup.

Key differences from Rojo

• Studio-first flow: Place hierarchy is authored in Studio, then mirrored locally.
• No required project file: You can start without a default.project.json.
• Targeted push tools: Use azul push mappings for repeatable imports.
• Rojo mode only when needed: Keep native behavior by default, opt into compatibility with --rojo.