Projects & Sync

Plugin Builder organizes your work into Projects. Each project contains everything needed for a complete plugin: the audio graph, faceplate UI, and all content assets.

Project Structure

A project includes:

Component	Description
Audio Graph	Node layout and connections
Faceplate	UI design and component layout
Content	Samples, images, and other assets
Metadata	Name, version, timestamps

Creating Projects

1. File → New Project (or Ctrl+N)
2. Enter a project name
3. Select the project type:
   • Plugin - Standard audio plugin
   • StyleSheet - Reusable UI theme
4. Click Create

Saving Projects

Projects save automatically, but you can also:

• Ctrl+S - Manual save
• File → Save As - Save a copy with a new name

Local Storage

Projects are stored locally at:

%APPDATA%/PluginBuilder/projects/{project_id}/
├── project.json       # Main project state
├── versions/          # Version history
└── content/           # Local content cache

Project Versions

Plugin Builder tracks versions of your project:

Property	Description
Version Number	Incremented on significant changes
Snapshot	Complete state at that version
Timestamp	When the version was created

Creating Versions

Versions are created:

• Automatically on major changes
• Manually via File → Save Version
• Before sync operations

Restoring Versions

1. File → Version History
2. Browse available versions
3. Click Restore to revert

Cloud Sync

Sync your projects to the cloud for backup, access across devices, and collaboration.

Setting Up Sync

1. Sign in to your account (File → Sign In)
2. Open a project
3. Click Sync in the toolbar (or File → Sync Project)

Sync States

State	Description
Synced	Local and cloud are identical
Local Changes	Unsaved local modifications
Remote Changes	Updates available from cloud
Conflict	Both local and remote changed

Automatic Sync

When enabled, projects sync automatically:

• On save
• On close
• Periodically in the background

Configure in Settings → Sync.

Content Management

Content Types

Type	Extensions	Storage
Samples	.wav, .aif, .mp3, .flac	Cloud (binary)
Images	.png, .jpg, .svg	Cloud (binary)
MIDI	.mid	Cloud (binary)
Presets	.preset	Cloud (JSON)

Content Categories

Category	Description	Exported
Plugin	Included in final plugin	Yes
Preview	For development only	No

Adding Content

1. Content → Import or drag files into the workspace
2. Content is copied to your project
3. Reference it from nodes (e.g., Sampler)

Content Sync

Content syncs separately from project state:

• Large files use efficient binary transfer
• SHA-256 checksums verify integrity
• Only changed content uploads

Exporting Plugins

When your plugin is ready:

1. File → Export Plugin
2. Choose export settings:
   • Plugin name
   • Version number
   • Format (VST3)
3. Click Export

The exported plugin includes:

• Compiled audio graph
• Baked faceplate UI
• All Plugin category content
• No source project data

Project Index

The Project Browser (File → Browse Projects) shows:

• All local projects
• Sync status
• Last modified date
• Project type

Filtering

• All - Show everything
• Synced - Cloud-backed projects
• Local Only - Not yet synced
• Archived - Hidden projects

Archiving

Archive projects you’re not actively working on:

• Right-click → Archive
• Archived projects don’t sync automatically
• Restore anytime via Show Archived

Collaboration

Sync enables basic collaboration:

1. Sync your project
2. Share project ID with collaborator
3. They can clone and work independently
4. Merge changes manually (advanced)

Full real-time collaboration is on the roadmap.