Package Management

When using Azul with package managers like Wally, you can use azul push to import packages into Studio.

Example:

azul push -s Packages -d ReplicatedStorage.Packages --destructive --rojo

Rojo-style layouts are usually standard for package managers, so the --rojo flag is needed to automatically convert from Rojo’s format to the format Azul uses.

Automating Package Pushes

Add a push mapping in per-place config so you can run plain azul push. Below are push mapping templates you can use.

Ember

Ember is a relatively new package manager for Luau. It is a great replacement for Wally, fixing many of its issues, supporting all the newest Luau features & fully supporting the Wally registry.

Ember is the recommended package manager for Azul.

pushMappings = {
    {
        source = "./packages/roblox",
        destination = { "ReplicatedStorage", "Packages" },
        destructive = true,
        rojoMode = true,
    },
}

For more information on Ember usage, see the Ember documentation.

Wally

Caution

Using Wally with Azul is not recommended. Wally has a number of issues that make it difficult to use with Azul (e.g. no type exports), and it is no longer actively maintained. If you are using Wally, consider switching to an alternative.

pushMappings = {
    {
        source = "./Packages",
        destination = { "ReplicatedStorage", "Packages" },
        destructive = true,
        rojoMode = true,
    },
}

For more information on Wally, see the Wally website.

Other Package Managers

If you are using a different package manager, you can create a custom push mapping to import packages into Studio. The logic is the same as the examples above: specify the local source folder, the Studio destination path, and whether to enable Rojo compatibility mode.