Documents
Welcome
Introducing
Why Misaki Studio
Compare
Start Here
Learn
Workflows
Export & Ship
AI & MCP
Questions & Answers
Reference
Troubleshooting
Installation and login troubleshooting
MCP connection troubleshooting
Preview and rendering troubleshooting
Export and build troubleshooting
Synchronization troubleshooting
Data and API troubleshooting
Examples

Synchronization troubleshooting

Use the desktop Sync Changes workspace for project incoming/outgoing review and history. Project sync is separate from design-file Undo, local/Git export, and session-only MCP activity marks.

Push is disabled

Refresh sync status and review incoming changes first. The current push action remains disabled while incoming work exists. Inspect files changed on both sides, apply/resolve the intended current state, rerun affected Preview/build checks, then review the outgoing set.

The change count is not enough to explain the change

Expand the file and nested node/property rows. Open the comparison and inspect before/after values; collapsed ancestors can summarize descendant changes.

I am unsure which version to restore

Compare the historical entry with its parent and the live project. When uncertain, copy or duplicate the historical file beside the live file and inspect it. In-place Restore This Version or Discard My Changes writes historical content into the live project as a new outgoing change; it does not rewrite history.

A deleted file needs recovery

Use the history action that restores a deleted file as a copy. Then review references and outgoing changes before pushing.

Undo did not reverse a push or pull

Design-file Undo moves through eligible content history; it is not a project-sync rollback. Use sync history and current comparison to plan recovery. Do not assume export or remote Git history matches Misaki project history.

Changes arrived while I was editing

Stop overlapping structural work, refresh, and reread the affected file before another write. Assign one owner to the conflict resolution and retest dependents after merging.

On this page
Synchronization troubleshooting
Push is disabled
The change count is not enough to explain the change
I am unsure which version to restore
A deleted file needs recovery
Undo did not reverse a push or pull
Changes arrived while I was editing