> For the complete documentation index, see [llms.txt](https://academy.shade.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.shade.inc/guides/guides.md).

# Guides

Step-by-step guides for getting real work done in Shade, from setting up your first drive to automating client delivery.

Each guide walks through one goal from start to finish. It combines several Shade features and links to the [Shade Academy](https://academy.shade.inc) whenever you want the full reference for one of them.

## Featured guides

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Your first automation</strong></td><td>Send every new upload into a review collection without lifting a finger. Ten minutes, no code.</td><td><a href="/guides/automations/your-first-automation.md">Your first automation</a></td></tr><tr><td><strong>The client review loop</strong></td><td>Share a cut, collect frame-accurate feedback, upload the next version, and get sign-off in one place.</td><td><a href="/guides/review-and-client-delivery/the-client-review-loop.md">The client review loop</a></td></tr><tr><td><strong>Model projects and clients as custom objects</strong></td><td>Track clients and projects inside Shade and connect every asset to the work it belongs to.</td><td><a href="/guides/custom-objects-and-metadata/model-projects-and-clients-as-custom-objects.md">Model projects and clients as custom objects</a></td></tr></tbody></table>

## Browse by category

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h3><i class="fa-rocket">:rocket:</i></h3></td><td><strong>Setup and migration</strong></td><td>Set up drives and permissions, and bring your existing media into Shade.</td><td><a href="/guides/setup-and-migration.md">Setup and migration</a></td></tr><tr><td><h3><i class="fa-film">:film:</i></h3></td><td><strong>Editing integrations</strong></td><td>Edit directly from Shade in Premiere Pro, DaVinci Resolve, Avid, and Final Cut Pro.</td><td><a href="/guides/editing-integrations.md">Editing integrations</a></td></tr><tr><td><h3><i class="fa-bolt">:bolt:</i></h3></td><td><strong>Automations</strong></td><td>Let Shade organize, share, and publish files for you when something happens in a drive.</td><td><a href="/guides/automations.md">Automations</a></td></tr><tr><td><h3><i class="fa-cubes">:cubes:</i></h3></td><td><strong>Custom objects and metadata</strong></td><td>Model your clients, projects, and deliverables, and design fields that stay consistent.</td><td><a href="/guides/custom-objects-and-metadata.md">Custom objects and metadata</a></td></tr><tr><td><h3><i class="fa-comments">:comments:</i></h3></td><td><strong>Review and client delivery</strong></td><td>Run review cycles, deliver finals, and work safely with people outside your team.</td><td><a href="/guides/review-and-client-delivery.md">Review and client delivery</a></td></tr><tr><td><h3><i class="fa-magnifying-glass">:magnifying-glass:</i></h3></td><td><strong>Search, AI, and archives</strong></td><td>Turn a pile of footage into a library you can search by what's in it.</td><td><a href="/guides/search-ai-and-archives.md">Search, AI, and archives</a></td></tr><tr><td><h3><i class="fa-code">:code:</i></h3></td><td><strong>Developers</strong></td><td>Build on Shade with the API, Python SDK, webhooks, and S3-compatible access.</td><td><a href="/guides/developers.md">Developers</a></td></tr></tbody></table>

## Start here

{% columns %}
{% column width="50%" %}
**New to Shade**

* [Your first week in Shade](/guides/setup-and-migration/your-first-week-in-shade.md)
* [Migrate from Dropbox or Google Drive](/guides/setup-and-migration/migrate-from-dropbox-or-google-drive.md)
* [Mass migrating data to Shade via Rclone](/guides/setup-and-migration/mass-migrating-data-to-shade-via-rclone.md)
  {% endcolumn %}

{% column width="50%" %}
**Editors**

* [How to use Shade with Adobe Premiere Pro](/guides/editing-integrations/how-to-use-shade-with-adobe-premiere-pro.md)
* [How to use Shade with DaVinci Resolve Projects](/guides/editing-integrations/how-to-use-shade-with-davinci-resolve-projects.md)
* [Edit remotely over ShadeFS](/guides/editing-integrations/edit-remotely-over-shadefs.md)
  {% endcolumn %}
  {% endcolumns %}

## Recently added

* [Your first automation](/guides/automations/your-first-automation.md)
* [Tell a client their files are ready](/guides/automations/tell-a-client-their-files-are-ready.md)
* [Model projects and clients as custom objects](/guides/custom-objects-and-metadata/model-projects-and-clients-as-custom-objects.md)
* [The client review loop](/guides/review-and-client-delivery/the-client-review-loop.md)
* [Your first week in Shade](/guides/setup-and-migration/your-first-week-in-shade.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://academy.shade.inc/guides/guides.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.