Project File and Sync Troubleshooting

Use this guide when the file tree, Projects Folder or runtime copy does not look current.

Identify the working copy

Every normal project works from Browser storage. An optional global Projects Folder mirrors all projects. The Linux runtime is a separate temporary server working tree used only when an authenticated compute feature is invoked.

Browser project missing after site-data cleanup

Choose Recover Projects Folder or Projects → Storage → Local Folder, then select the previously used directory. No login is required. Learnitive scans child .learnitive/project.json manifests and rebuilds Browser workspaces.

Projects Folder needs permission

If Storage shows Access required, choose Grant access. Learnitive never requests filesystem permission in the background. Browser saves remain available while synchronization is paused.

External edits

If you changed a synchronized file in another editor, return to Learnitive or choose Sync now. Local-only changes are reconciled into Browser storage. Same-file changes on both sides are surfaced as conflicts.

Deleted while disconnected

If you delete a Browser project while the Projects Folder is disconnected, an older local backup can still exist. A later recovery may offer that project again because there is intentionally no cloud deletion journal. Reconnect before deletion when you want the folder copy tombstoned too.

Related guides

Read Project Storage and Recovery, Projects Folder, ZIP Import and Export and Terminal Sync.