Working with Workspaces

Create a workspace, make changes safely, resolve conflicts, and merge your work back into Main.

Working with Workspaces

Workspaces are isolated editing environments within a project. Think of them like branches in version control — they let you change your design without affecting Main, the merged state everyone on your team shares. When you're happy with your changes, you merge the workspace back into Main.

Main is read-only, so you need a workspace before you can create or edit anything.

Creating a Workspace

Step 1: Open the Workspace Switcher

On the right of the header, click the button with the branch icon. It shows Main when no workspace is selected.

Step 2: Click "Create Workspace"

At the bottom of the menu, click Create Workspace. A dialog opens.

Step 3: Name Your Workspace

Enter a Workspace Name (e.g. "Balance Update Sprint 1") and click Create Workspace. Leap shows "Creating workspace…" and then switches you into the new workspace.

Step 4: Start Editing

The header button now shows your workspace's name. Everything you create or change is saved to this workspace and doesn't affect Main until you merge. A new workspace starts from Main as it was at the moment you created it.

Switching Workspaces

Open the switcher and pick Main or any workspace from the list. Leap shows "Switching workspace…" and reloads the project.

Important: Unsaved Inspector edits are discarded when you switch. Save your work first.

Merging Back to Main

Step 1: Start the Merge

While you're in the workspace, open the switcher and click Merge to Main.

Step 2: Review Changes

The dialog opens on Review changes before merging. After "Analyzing changes...", Leap lists everything the merge will change, counted as New, Modified and Removed and grouped by kind of element. Switch between High-level and Detailed, or use Search changes… to find something specific; expand a row to see exactly which fields changed. If your workspace matches Main, you'll see "No changes to merge."

If nobody changed the same elements on Main in the meantime, click Continue to Merge and skip to Step 4.

Step 3: Resolve Conflicts

If an element you changed was also changed on Main since your workspace was created, click Resolve Conflicts. For each conflict, choose Keep main or Keep workspace, or click Choose changes individually to keep some changes from each side. Under Resolve all remaining, Take main and Take workspace settle everything that's left in one click. When a system is in conflict, its Main and Workspace versions are shown side by side as graphs.

If the only difference is where nodes sit on a canvas, Leap resolves it for you and keeps your workspace's layout.

Step 4: Confirm and Merge

On Confirm and merge, review the summary once more and enter a Merge Message describing the change. It's required: Merge to Main stays disabled until it's filled in. Then click Merge to Main.

When the merge completes, you're back on Main with your changes in it, and the workspace is removed. A message confirms the merge: "Merged "{name}" to main." Create a new workspace for your next round of changes.

When a Merge Is Refused

Merging checks that your whole design fits together. If it doesn't, the dialog shows "This workspace can’t be merged until these are fixed:" and lists each problem: what is wrong, the elements involved, and How to fix it. Click an element to open it — a system opens in its editor, anything else is highlighted in the Element Explorer. The most common problems:

Uses an element that no longer exists — an element still uses one that has been deleted. Open it and choose another element, or remove that value.
Uses a state that no longer exists — a condition or an exit names a state that is no longer in its system. Choose an existing state.
Uses an element it can’t reach — an element uses another one that is out of its reach. See Organizing Your Project for which elements can use which.
Uses the wrong kind of element — a field points at an element of a kind it doesn't take. Pick one of the right kind.
Elements use each other in a loop — change one of them so the loop is broken. See Formulas.

Fix the elements in your workspace, save them, and click Check again. Technical details under a problem shows Leap's own message, and Copy details copies the whole list if you need to send it to support.

Closing a Workspace

To drop a workspace without merging it, switch into it, open the switcher and click Close Workspace.

Important: Closing a workspace permanently deletes it, together with every change in it that hasn't been merged. This can't be undone.

Next Steps

With your workspace active, you can start building — head over to Creating Resources to add your first resource.