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

# Project Overview

> A visual dashboard of all your iCloud projects, grouped by workflow status.

The Project Overview gives you a bird's-eye view of every Gridshift project stored in iCloud Drive. Projects are grouped by their workflow status and displayed as artwork cards in horizontal carousels, so you can see at a glance what needs attention.

Open it with `⌘P`, or from the Command Palette (`⌘K`) by searching for **"Project Overview"**.

## Status Levels

Each project carries a workflow status that tracks its production stage. The overview groups projects into sections by status:

| Status        | Icon      | Description                  |
| ------------- | --------- | ---------------------------- |
| **Draft**     | Pencil    | Initial ideas and sketches   |
| **Flesh Out** | Hammer    | Building out the arrangement |
| **Polish**    | Sparkles  | Mixing and fine-tuning       |
| **Released**  | Checkmark | Final, published version     |
| **Archived**  | Archive   | No longer active             |

Set a project's status in the [Project inspector tab](/features/inspector#project) under **Info**.

## Features

### Artwork Thumbnails

Each project card shows the artwork thumbnail saved in its project bundle. Projects without custom artwork display a placeholder icon.

### Quick-Open

Click any project card to open it. If the current project has unsaved changes, Gridshift prompts you to save before switching.

### New Project

The **New Project** button in the top-right corner creates a fresh project (using your [default project](/features/default-project) template if one is set).

### iCloud Sync

The overview monitors iCloud Drive with a live metadata query. Projects saved on other devices appear automatically once synced. Only fully downloaded bundles show manifest details (artwork, BPM); evicted bundles are skipped until re-downloaded.

## Project Overview vs. Project Inspector Tab

|                | Project Overview (`⌘P`)             | Project Inspector Tab (`⌘5`)          |
| -------------- | ----------------------------------- | ------------------------------------- |
| **Scope**      | All iCloud projects                 | Current project only                  |
| **Purpose**    | Browse, filter, and switch projects | Edit settings, metadata, and versions |
| **Layout**     | Artwork cards grouped by status     | Form-based settings panels            |
| **Opens with** | `⌘P`                                | `⌘5`                                  |

## Shortcuts

The keys for opening and switching projects. The [Global Shortcuts](/shortcuts/global) reference has the complete grid — transport, file operations, and inspector tabs.

| Action                     | Shortcut |
| -------------------------- | -------- |
| Open Project Overview      | `⌘P`     |
| Command Palette            | `⌘K`     |
| New project                | `⌘N`     |
| Show Project inspector tab | `⌘5`     |
