# Forma

### 1. Create your first project in Finch

* Navigate to the **`Projects`** page in the web-app and select **`Create New`**. Give your project a name and hit **`OK`**.

<figure><img src="/files/p2vbGtoD9Iaoab0pDksE" alt=""><figcaption></figcaption></figure>

### 2. Switch over to Forma and install the Finch extension

* Enter your project in Forma. Under the **`Extensions`** category on the left-hand menu, click **`+Add Extension`** . This will open the Autodesk App Store.
* In the App Store, search for **`Finch`** in the **`Search Bar`** in the top left corner or browse the extension library. Select the extension and **`Add`** it to the project.
* Agree to the Terms and Conditions and close the App Store to go back to your Forma project.

{% hint style="info" %}
The extension will need to be added again for every new project that you intend to send to Finch.
{% endhint %}

### 3. Send your project to Finch

* Under the **`Extensions`** category on the left-hand menu, open the **`Finch`** extension.
* Sign in with your Finch account.
* Select the project and variant that you want to upload to and click **`Send to Finch`** .
* When the process is complete, an **`Upload successful`** popup will appear in the bottom-left corner. Click on **`Open variant in Finch`**. This will open your Finch project in a new tab in your browser.

{% hint style="info" %}
Current limitations:

Only building volumes created with **`Basic Buildings`** or **`Line-edited buildings`** can be uploaded as editable volumes in Finch. All other types, such as **`3D Buildings`** and **`Generic Volumes`** will be uploaded into the **`Generic`** layer and be treated as part of the context.
{% endhint %}


---

# Agent Instructions: 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 current page URL with the `ask` query parameter:

```
GET https://docs.finch3d.com/docs/first-steps/forma.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
