> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ghostable.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Manifest Sync

> Use Desktop to keep `.ghostable/ghostable.yaml` aligned with the linked Ghostable project.

<Card title="Read the shared project model" icon="circle-info" href="/fundamentals/v2/core-objects/projects">
  The manifest is safe metadata that connects a local repo to a Ghostable project.
</Card>

## What Gets Synced

Desktop uses the linked project folder to locate `.ghostable/ghostable.yaml`, then syncs the local
manifest with the project's current metadata.

That includes safe information such as:

* project identity,
* stack profile,
* deployment provider,
* known environments.

## How to Sync

1. Open the project window.
2. Go to **Settings**.
3. Confirm a local folder is linked.
4. Click **Sync Manifest** in the **Local Folder** section.

If the manifest already exists, Desktop updates it in place. If the file is missing, the linked
folder must be corrected before sync can succeed.

{/* ghostable:screenshot-output desktop-manifest-sync-project-settings:start */}

<img className="block dark:hidden w-full" src="https://mintcdn.com/ghostable/BOl2AUG1DFr1k8ob/images/generated/screenshots/ghostable-desktop/project-settings-local-folder-light.png?fit=max&auto=format&n=BOl2AUG1DFr1k8ob&q=85&s=707f4ddd37ed2212605260fb5e80294e" alt="Ghostable desktop project settings view showing the linked folder details and Sync Manifest action in the local folder section." width="2080" height="1384" data-path="images/generated/screenshots/ghostable-desktop/project-settings-local-folder-light.png" />

<img className="hidden dark:block w-full" src="https://mintcdn.com/ghostable/BOl2AUG1DFr1k8ob/images/generated/screenshots/ghostable-desktop/project-settings-local-folder-dark.png?fit=max&auto=format&n=BOl2AUG1DFr1k8ob&q=85&s=f82ac2d9c055a9bec17a69535ff6b20b" alt="Ghostable desktop project settings view showing the linked folder details and Sync Manifest action in the local folder section." width="2080" height="1384" data-path="images/generated/screenshots/ghostable-desktop/project-settings-local-folder-dark.png" />

## Related Actions

Project Settings also lets you:

* open the linked folder,
* open the manifest directly,
* change the linked folder,
* unlink the local folder entirely.

## Continue

<CardGroup>
  <Card title="Link a folder first" icon="folder-open" href="/desktop/v1/local-integration/link-a-folder">
    Set up the local path before you rely on manifest sync.
  </Card>

  <Card title="CLI project init" icon="terminal" href="/cli/v2/workflows/projects">
    Use the terminal workflow when you need to bootstrap the same manifest from a shell.
  </Card>
</CardGroup>
