ember
Documentation menuembr 0.13.0

Commands

embr migrate

Last updated November 2, 2026

Moves a project from pesde, Wally, Forest, or Crater to Ember.

embr migrate [-y]

embr migrate finds pesde.toml, wally.toml, forest.json, and crater.json in the current directory and lists them, all checked. It moves the files that stay checked into ember.toml, and writes ember.toml when there is none. Without a terminal, or with --yes, it moves every file it finds.

What moves and what stays#

Each setting that Ember has a place for moves to ember.toml, and leaves its old file. A setting that Ember has no place for stays in the old file, so a field that a later version of the other tool adds is never lost. A file with nothing left in it is deleted.

ember.toml wins. Where it already sets a key, its own value stays, and the entry in the old file goes all the same. The command names each such key.

A migration that would leave ember.toml unreadable writes nothing at all.

Lockfiles stay: pesde.lock, wally.lock, forest-lock.json, and crater.lock. The next embr install resolves again and writes ember.lock.

pesde#

pesde.tomlember.toml
name, version, description, license, repository, private[package]
authors, when each one is a GitHub username[package] authors
[target] environment[target] environment
[target] lib[target] main
includes, workspace_members[target] includes, workspace
[indices], [wally_indices][indices]
{ name = ... }, { wally = ... }, { workspace = ... } dependencies[dependencies]
[overrides], "foo>bar"[overrides], "foo.bar"
[scripts] build = "scripts/build.luau"[scripts] build = "lune run scripts/build.luau"

pesde's default index becomes pesde, and its default Wally index becomes wally. So a project that already uses Ember's own default index keeps it.

pesde runs a script with Lune, so each script becomes a lune run command. embr run appends its arguments to the command line, so the script reads the same process.args. Lune has to be on PATH: embr tool add lune-org/lune pins it for the project.

These stay in pesde.toml: git and path dependencies, [dev_dependencies], [peer_dependencies], [engines], [patches], [place], [target] bin, and the sourcemap_generator hook, which pesde runs by itself.

Wally#

wally.tomlember.toml
[package] name, version, description, license, private[package]
[package] authors, when each one is a GitHub username[package] authors
[package] realm[target] environment
[package] include, exclude[target] includes, excludes
[package] registry[indices] wally
[dependencies][dependencies], index = "wally"
[server-dependencies][dependencies], target = "roblox_server"

These stay in wally.toml: [dev-dependencies], [place], and the dev realm.

Forest#

forest.jsonember.toml
author and name[package] name, as author/name
version, description, license[package]
platform = "roblox"[target] environment = "roblox"
root[target] main
dependencies[dependencies], index = "forest", keyed by the alias

These stay in forest.json: mounts, overrides, excludes, packagesDir, visibility, and every field of a UEFN project, which Ember does not install.

Crater#

Ember reads Crater's rules from .crater-declare, the file that Crater 0.5.5 and later write beside crater.json: the address of each registry name, the realm of each dependency list, and the default of each field.

A crater.json with no .crater-declare beside it does not migrate. Run any Crater command once to write the file.

crater.jsonember.toml
name, version, description, license, repository[package]
authors, when each one is a GitHub username[package] authors
can_publish[package] private, the opposite value
icon, a .png, .jpg, .webp, or .gif file (.gif from embr 0.13.0)[package] logo
import_to = "client" or "shared"[target] environment = "roblox"
import_to = "server"[target] environment = "roblox_server"
path_to_main, workspace[target] main, workspace
package_files.exclude, or exclude before Crater 0.5.7[target] excludes
import_client[dependencies]
import_server[dependencies], target = "roblox_server"
scripts[scripts], as they are
tools, owner/repo@version[tools]

A dependency moves when Ember can install it: one whose registry name, ember#, wally#, pesde#, forest#, or one of the project's own registries, is at an address Ember reads. An ember# dependency takes index = "ember" and needs no [indices] entry. A dependency with no registry name moves when registry names one such index alone, and registry then moves to [indices]. The alias before : is the key, else the short name, as Crater names the link file.

crater.jsonember.toml
a/b or a/b^version = "^", the latest
a/b^1.2.3, a/b@1.2.3version = "^1.2.3"
a/b=1.2.3version = "=1.2.3"
a/b+1.2.3version = ">=1.2.3"
a/b~1.2.3version = "~1.2.3"

These stay in crater.json: packages of a Crater registry, which Ember does not read, path: and git+ dependencies, import_develop, registry, registries, overrides, keywords, path_to_definition_files, allow_files, and the script policy. crater init writes every field, and a field equal to its default goes. crater.settings.json stays as it is.

See also#

  • embr index for the wally, pesde, and forest indices.
  • embr init to start a manifest from nothing.