Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.workshop.ai/llms.txt

Use this file to discover all available pages before exploring further.

Workshop Cloud and Workshop Desktop can sync project files directly, without a separate GitHub repository. This lets you start a project on the web, continue on desktop, and push changes back — or the other way around.
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:
ActionWhat happens
Push from DesktopSends your local project files to Workshop Cloud
Pull to DesktopDownloads the latest files from Workshop Cloud into your local project
Push from CloudSends your cloud project files to Workshop Desktop
Pull to CloudDownloads the latest files from Workshop Desktop into your cloud project
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

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. It shows:
  • The last push and pull timestamps
  • Sync status (when refreshed)
  • Three action buttons:
ButtonAction
Up arrowPush your changes to the other environment
Down arrowPull changes from the other environment
RefreshCheck the current sync status

​
Sync Status

After clicking Refresh, the status indicator shows:
StatusMeaning
In syncBoth sides have the same files
Local aheadYou have unpushed local changes
Remote aheadThe other side has changes you haven’t pulled
DivergedBoth sides have independent changes

​
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.
Force pull is a destructive operation. The overwritten local changes cannot be recovered. Make sure you know which version you want to keep before confirming.

​
Web ↔ Desktop Sync vs GitHub Integration

Both features sync project files, but they serve different purposes:
Web ↔ Desktop SyncGitHub Integration
PurposeMove files between Workshop Cloud and DesktopVersion control with your own GitHub repo
GitHub account requiredNoYes
CollaborationBetween your own Cloud and Desktop environmentsWith anyone who has access to the repo
Use togetherYes — both can be active on the same projectYes