> For the complete documentation index, see [llms.txt](https://docs.tonic.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tonic.ai/fabricate/projects/projects-create-manage.md).

# Creating and managing projects

Every workspace contains at least one project.

A workspace project contains one or more local databases and database connections, along with the workflows, plans, and mock API endpoints used to generate and work with the data.

The Data Agent chat spans the project.

## Creating a project

To add a project to the current workspace:

1. Either:
   1. In the navigation panel heading, click the **+** icon.
   2. On the[ project center](/fabricate/projects/project-manager.md) or [project selection panel](/fabricate/projects/viewing-the-project-overview.md#project-open-from-project), click **New Project**.
2. On the **New AI Project** panel, in the **Project name** field, provide the name of the new project.

<figure><img src="https://4109733485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmoU4gTR9LxlzHeWmQCUZ%2Fuploads%2FkTYW3MQlBN2dZM8uylCJ%2FProject_NewAIProject.png?alt=media&amp;token=382a23c3-bacf-436a-b538-c72ece7e52ab" alt=""><figcaption><p>New AI Project panel to create a new project</p></figcaption></figure>

3. Click **Create project**.
4. Fabricate prompts you for information about the first database to add to the project.

## Changing the name of a project

To change the name of a project:

1. Either:
   * In the project navigation panel or on the [project center](/fabricate/projects/project-manager.md), click the options menu for the project, then click **Rename**.
   * In the heading of the [project overview](/fabricate/projects/viewing-the-project-overview.md), click the rename icon.

<figure><img src="https://4109733485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmoU4gTR9LxlzHeWmQCUZ%2Fuploads%2FGAasjqX5UB3AHym6osiV%2FProject_OptionsMenu.png?alt=media&amp;token=49c6f757-25d9-4295-929a-abbd7a9f9f71" alt=""><figcaption><p>Options menu for the project, with the option to rename the project</p></figcaption></figure>

<figure><img src="https://4109733485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmoU4gTR9LxlzHeWmQCUZ%2Fuploads%2FoiWjRy2Lnh4Rr2j1cd1o%2FProject_ProjectOverviewHeading.png?alt=media&amp;token=c4843cde-2b3d-42e1-85f5-34b67ed31205" alt=""><figcaption><p>Project overview heading with options for managing projects</p></figcaption></figure>

2. In the **Project name** field, provide the new name for the project.

<figure><img src="https://4109733485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmoU4gTR9LxlzHeWmQCUZ%2Fuploads%2FVoTm1zvNQ6RdtSn3he2O%2FProject_Rename.png?alt=media&amp;token=b4cdd20f-b1bc-478a-a71d-c9b2144702bf" alt=""><figcaption><p>Rename Project panel to provide the new name for the project</p></figcaption></figure>

4. Click **Rename**.

## Moving projects to a different workspace <a href="#project-change-workspace" id="project-change-workspace"></a>

### Moving a single project <a href="#project-move-single" id="project-move-single"></a>

To move a single project to a different workspace:

1. Either:
   * In the project navigation panel or on the [project center](/fabricate/projects/project-manager.md), click the options menu for the project, then click **Move to Workspace**.
   * In the heading of the [project overview](/fabricate/projects/viewing-the-project-overview.md), click the move to workspace icon.

<figure><img src="https://4109733485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmoU4gTR9LxlzHeWmQCUZ%2Fuploads%2FGAasjqX5UB3AHym6osiV%2FProject_OptionsMenu.png?alt=media&amp;token=49c6f757-25d9-4295-929a-abbd7a9f9f71" alt=""><figcaption><p>Options menu for the project, with the option to move the project to a different workspace</p></figcaption></figure>

<figure><img src="https://4109733485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmoU4gTR9LxlzHeWmQCUZ%2Fuploads%2FoiWjRy2Lnh4Rr2j1cd1o%2FProject_ProjectOverviewHeading.png?alt=media&amp;token=c4843cde-2b3d-42e1-85f5-34b67ed31205" alt=""><figcaption><p>Project overview heading with options for managing projects</p></figcaption></figure>

2. From the workspace dropdown list, select the workspace to move the project to.

<figure><img src="https://4109733485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmoU4gTR9LxlzHeWmQCUZ%2Fuploads%2FCYTrUB2OeR9B3xBY72Jg%2FProject_MoveToWorkspace.png?alt=media&amp;token=e799a02c-8288-4643-8c14-62399182916e" alt=""><figcaption><p>Move Project panel to select the workspace to move a project to</p></figcaption></figure>

4. Click **Move**.

### Moving multiple projects <a href="#project-move-multiple" id="project-move-multiple"></a>

From the [project center](/fabricate/projects/project-manager.md), to move multiple projects to the same workspace:

1. In the project list, shift-click each project to move.
2. Click **Move To**.

<figure><img src="https://4109733485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmoU4gTR9LxlzHeWmQCUZ%2Fuploads%2Ft9S8dS6Qm7wOCIfEQY29%2FProjectCenter_MultiSelect.png?alt=media&amp;token=163aacc9-13fc-45aa-9dd6-83a2da57ba01" alt=""><figcaption><p>Project center with multiple projects selected</p></figcaption></figure>

3. From the workspace dropdown list, select the workspace to move the projects to.
4. Click **Move**.

## Cloning projects

You can create a copy of project. The clone includes all of the local databases and data connection, and can optionally include the project chat history.

To clone a project.

1. Either:
   * In the project navigation panel or on the [project center](/fabricate/projects/project-manager.md), click the options menu for the project, then click **Clone**.
   * In the heading of the [project overview](/fabricate/projects/viewing-the-project-overview.md), click the clone project icon.

<figure><img src="https://4109733485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmoU4gTR9LxlzHeWmQCUZ%2Fuploads%2FGAasjqX5UB3AHym6osiV%2FProject_OptionsMenu.png?alt=media&amp;token=49c6f757-25d9-4295-929a-abbd7a9f9f71" alt=""><figcaption><p>Options menu for the project, with the option to clone the project</p></figcaption></figure>

<figure><img src="https://4109733485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmoU4gTR9LxlzHeWmQCUZ%2Fuploads%2FoiWjRy2Lnh4Rr2j1cd1o%2FProject_ProjectOverviewHeading.png?alt=media&amp;token=c4843cde-2b3d-42e1-85f5-34b67ed31205" alt=""><figcaption><p>Project overview heading with options for managing projects</p></figcaption></figure>

2. On the **Clone Project** panel, in the **New project name** field, provide the name for the cloned project.

<figure><img src="https://4109733485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmoU4gTR9LxlzHeWmQCUZ%2Fuploads%2FqkXGFg2I8AayMKWCeSfO%2FProject_CloneProjectPanel.png?alt=media&amp;token=ba89bc56-4422-4b8a-9aa6-b7163acb8afa" alt=""><figcaption><p>Clone project panel to create a copy of a project</p></figcaption></figure>

4. From the **Workspace** dropdown list, select the workspace to put the cloned project into.
5. To include the chat history from the original project in the cloned project, check the Include chat checkbox.
6. Click **Clone**.

## Deleting projects

When you delete a project, you also delete the project's local databases and database connections.

### Deleting a single project <a href="#project-delete-single" id="project-delete-single"></a>

To delete a single project:

1. Either:
   1. In the project navigation panel or on the [project center](/fabricate/projects/project-manager.md), click the options menu for the project, then click **Delete**.
   2. &#x20;the heading of the [project overview](/fabricate/projects/viewing-the-project-overview.md), click the delete project icon.

<figure><img src="https://4109733485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmoU4gTR9LxlzHeWmQCUZ%2Fuploads%2FGAasjqX5UB3AHym6osiV%2FProject_OptionsMenu.png?alt=media&amp;token=49c6f757-25d9-4295-929a-abbd7a9f9f71" alt=""><figcaption><p>Options menu for the project, with the option to delete the project</p></figcaption></figure>

<figure><img src="https://4109733485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmoU4gTR9LxlzHeWmQCUZ%2Fuploads%2FoiWjRy2Lnh4Rr2j1cd1o%2FProject_ProjectOverviewHeading.png?alt=media&amp;token=c4843cde-2b3d-42e1-85f5-34b67ed31205" alt=""><figcaption><p>Project overview heading with options for managing projects</p></figcaption></figure>

2. On the confirmation panel, click **Delete Project**.

### Deleting multiple projects <a href="#project-delete-multiple" id="project-delete-multiple"></a>

From the [project center](/fabricate/projects/project-manager.md), to delete multiple projects:

1. In the project list, shift-click each project to delete.
2. Click **Delete**.

<figure><img src="https://4109733485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmoU4gTR9LxlzHeWmQCUZ%2Fuploads%2Ft9S8dS6Qm7wOCIfEQY29%2FProjectCenter_MultiSelect.png?alt=media&amp;token=163aacc9-13fc-45aa-9dd6-83a2da57ba01" alt=""><figcaption><p>Project center with multiple projects selected</p></figcaption></figure>

3. On the confirmation panel, click **Delete**.


---

# 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.tonic.ai/fabricate/projects/projects-create-manage.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.