Web ↔ Desktop Sync is separate from GitHub Integration. GitHub sync connects your project to your own repository for version control and collaboration. Web ↔ Desktop Sync moves files between Workshop’s two environments — no GitHub account required.
How It Works
Push and pull to move your project files between Workshop Cloud and Workshop Desktop:
Syncing is manual — you decide when to push and pull. Nothing happens automatically.
Getting Started
Starting from Workshop Cloud
1
Create and build a project in Workshop Cloud
Build your project on the web as usual. Your files are stored in the cloud workspace.
2
Push to sync
Open the project settings and click Push in the Web ↔ Desktop Sync section. This sends your project files so Desktop can download them.
3
Download on Desktop
In Workshop Desktop, go to the Projects page. Cloud projects that haven’t been downloaded yet appear at the top. Click the download button to pull the project files to your machine.
4
Continue building
Your project is now on Desktop with all its files. Push and pull as needed to keep both sides up to date.
Starting from Workshop Desktop
The Web ↔ Desktop Sync section only appears for a project that was downloaded from Workshop Cloud. A project created directly in Workshop Desktop does not have this section. To move a Desktop-created project to Workshop Cloud or another machine, use GitHub Integration instead.
1
Open the project settings on Desktop
Navigate to your project and open the settings panel. The Web ↔ Desktop Sync section appears under Integrations.
2
Push to sync
Click the Push to web button (up arrow). This sends your local project files so Workshop Cloud can access them.
3
Open in Workshop Cloud
Sign in to Workshop Cloud with the same account. Your project appears in the project list. Open it and pull the latest changes.
Using the Sync Controls
The Web ↔ Desktop Sync section appears in the project settings panel under Integrations. In Workshop Cloud it is always available; in Workshop Desktop it appears only for projects that were downloaded from Workshop Cloud. It shows:- The last push and pull timestamps
- Sync status (when refreshed)
- Three action buttons:
Sync Status
After clicking Refresh, the status indicator shows:Handling Conflicts
If both Workshop Cloud and Desktop have made independent changes to the same project, a pull may result in a merge conflict. Workshop detects this and prompts you:- Force pull overwrites your local files with the other side’s version. Workshop asks for confirmation before proceeding.