Boomi Build — VS Code Extension
Browse, sync, and visually explore your Boomi AtomSphere Build page components directly inside VS Code.
Features
- Secure sign-in — account credentials stored in VS Code's encrypted SecretStorage (never written to disk)
- Build page tree view — mirrors your Boomi folder hierarchy with components grouped by type (
processes/, connections/, maps/, etc.)
- Process canvas — click any process to see a visual canvas of its shapes and connections, just like the Boomi Build page
- Lazy loading — folders and components are fetched on demand as you expand nodes
- Open component XML — right-click any component to view its raw XML in the editor
- Sync to workspace — right-click a folder or component to download it into
boomi-build/ in your workspace
- Sync & Stage — sync a component or folder and immediately stage the files for git
- Credential stripping — passwords and API keys are automatically removed from connection XML before writing to disk
Sign In
- Open the Boomi Build panel in the Activity Bar (B icon)
- Click Sign in to Boomi AtomSphere
- Enter your Account ID, email, and API Token
Your API token can be generated at:
Boomi AtomSphere → Settings → Account Information → API Tokens
Process Canvas
Click any process component to open a visual canvas showing:
- All shapes (Start, Stop, Connector, Map, Branch, Decision, Notify, and 20+ more) rendered with Boomi-style icons and colours
- Arrows connecting shapes
- Hover over any shape to see its label and type
- Pan (drag) and zoom (scroll wheel) the canvas
- Fit / + / − toolbar buttons to navigate
Commands
| Command |
Description |
Boomi: Sign in |
Connect to AtomSphere |
Boomi: Sign out |
Disconnect |
Boomi: Refresh |
Reload the tree |
| Right-click process → View Canvas |
Open visual process canvas |
| Right-click folder → Sync Folder |
Download all components recursively |
| Right-click folder → Sync & Stage Folder |
Download and git-stage a folder |
| Right-click component → Sync Component |
Download single component |
| Right-click component → Sync & Stage Component |
Download and git-stage a component |
| Right-click component → Open Component XML |
View XML in editor |
| Right-click component → Copy Component ID |
Copy UUID to clipboard |
Settings
| Setting |
Default |
Description |
boomi.syncOutputDir |
boomi-build |
Output directory relative to workspace root |
boomi.stripCredentials |
true |
Strip passwords/tokens from connection XML |
Requirements
- VS Code 1.85 or later
- A Boomi AtomSphere account with API Token access
Development
npm install
npm run build # one-time build
npm run watch # rebuild on change
npm run compile-check # TypeScript type check only
Press F5 in VS Code to open an Extension Development Host with the extension loaded.
| |