> For the complete documentation index, see [llms.txt](https://docs.finch3d.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.finch3d.com/docs/first-steps/forma.md).

# 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
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 current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.