Workspaces

Workspaces

A Buildprint workspace is a local copy of one Bubble app branch. Each branch gets its own folder, and that folder is also a normal git worktree.

Create your first workspace

1. Link the CLI once with buildprint link <token>.

2. List available projects with buildprint project list.

3. Clone the default branch workspace with buildprint project get <appname>.

4. Change into the branch folder the CLI prints at the end of the command.

App root vs branch folder

• <app-root>/ is the shared home for one Bubble app.

• <app-root>/<branch>/ is the workspace for one Bubble branch such as test or live.

• Most day-to-day commands should be run from the branch folder or one of its subfolders.

Working with more than one branch

You can create more than one branch workspace for the same app under the same app root.

• buildprint project get my-app --branch test

• buildprint project get my-app --branch live

That gives you sibling folders for each Bubble branch. To switch branches, change directories into the other branch folder. Treat each folder as the local home for that one Bubble branch.

Where commands should run

• buildprint sync, buildprint check, buildprint apply, and buildprint tree should be run from inside the branch workspace.

• Commands like buildprint link and buildprint project list are not tied to one workspace and can be run elsewhere.

Branch safety checks

• The folder name and the checked-out git branch are expected to match.

• If they do not match, Buildprint stops and tells you what to cd or git checkout.

• This prevents accidental sync or apply operations against the wrong branch workspace.