> ## 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.

# Projects

> Projects connect environments, stack metadata, and local manifests for a single app.

<Card title="Need the full platform overview?" icon="circle-info" href="/fundamentals/v2/overview/what-is-ghostable">
  Review how Ghostable fits Desktop, CLI, and automation together.
</Card>

## What a Project Represents

A project is the Ghostable record for one application or service inside an organization. It groups:

* The environments that belong to that app.
* Stack metadata such as language, framework, and deployment provider.
* Activity and validation context tied to that app.
* Optional local folder linkage through the Ghostable manifest.

Projects are the boundary where most day-to-day work starts.

{/* ghostable:screenshot-output fundamentals-projects-environments-list:start */}

<img className="block dark:hidden w-full rounded-xl" src="https://mintcdn.com/ghostable/BOl2AUG1DFr1k8ob/images/generated/screenshots/ghostable-server/control-plane-environments-list-light.png?fit=max&auto=format&n=BOl2AUG1DFr1k8ob&q=85&s=9cced2684e598b789d089e9e79d18b3c" alt="Ghostable project view showing environments within a single project in the web app." width="1256" height="243" data-path="images/generated/screenshots/ghostable-server/control-plane-environments-list-light.png" />

<img className="hidden dark:block w-full rounded-xl" src="https://mintcdn.com/ghostable/BOl2AUG1DFr1k8ob/images/generated/screenshots/ghostable-server/control-plane-environments-list-dark.png?fit=max&auto=format&n=BOl2AUG1DFr1k8ob&q=85&s=d17d9deac8e2fb875e0c9797fe87df4b" alt="Ghostable project view showing environments within a single project in the web app." width="1256" height="243" data-path="images/generated/screenshots/ghostable-server/control-plane-environments-list-dark.png" />

## Stack Metadata and Local Context

Ghostable stores lightweight, non-secret project metadata so clients can tailor workflows. Common
examples include the primary language, framework, and deployment platform.

The local manifest, `.ghostable/ghostable.yaml`, lets clients map a local folder back to the
project. It contains safe metadata only and is intended to live in version control.

## Where You Manage Projects

* **Desktop**: create projects from the launcher or organization window, then manage local folder
  linkage from Project Settings.
* **CLI**: initialize or link a repo with `ghostable init` and keep the manifest in sync locally.
* **Web app**: organization owners can review project-level settings outside the local clients.

## Continue with Your Client

<CardGroup>
  <Card title="Use the Desktop app" icon="laptop" href="/desktop/v1/daily-work/organizations-and-projects">
    Create and manage projects from the launcher and organization views.
  </Card>

  <Card title="Use the CLI" icon="terminal" href="/cli/v2/workflows/projects">
    Bootstrap or relink a repository with the terminal workflow.
  </Card>
</CardGroup>
