> 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/project-and-database-management/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

The project is added to the current workspace, which is listed with the account under the user name.

<figure><img src="/files/IG1bfkMYWNMgvRgxxm66" alt=""><figcaption><p>Identifying the currently selected workspace</p></figcaption></figure>

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/project-and-database-management/project-manager.md) or [project selection panel](#switching-to-another-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="/files/Q3h0Du7kkFibWX15uyPq" 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. In the project navigation panel or on the [project center](/fabricate/project-and-database-management/project-manager.md), click the options menu for the project.
2. In the project options menu, click **Rename**.

<figure><img src="/files/2hpqq72wzSxyM1YL3uO3" alt=""><figcaption><p>Options menu for the project, with the option to rename the project</p></figcaption></figure>

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

<figure><img src="/files/aB9eRQetAQ7Cl7ob2IP1" alt=""><figcaption><p>Rename Project panel to provide the new name for the project</p></figcaption></figure>

4. Click **Rename**.

## Opening the details for a project

### From within a different project <a href="#project-open-from-project" id="project-open-from-project"></a>

From within a project, to change to a different project:

1. Click the find icon.
2. The project selection panel displays a tree structure of workspaces and projects.

<figure><img src="/files/GggZ0PmwRwf6dJfXXgEj" alt=""><figcaption><p>Navigation panel to switch to a different project</p></figcaption></figure>

3. To search for a project, begin to type the project name.
4. In the project list, click the project to open.

### From the project center <a href="#project-open-project-center" id="project-open-project-center"></a>

From a project list on the [project center](/fabricate/project-and-database-management/project-manager.md), to display the details for a project, double-click the project row.

## 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. In the project navigation panel or on the [project center](/fabricate/project-and-database-management/project-manager.md), click the options menu for the project.
2. In the menu, click **Move to Workspace**.

<figure><img src="/files/2hpqq72wzSxyM1YL3uO3" alt=""><figcaption><p>Options menu for the project, with the option to move the project to a different workspace</p></figcaption></figure>

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

<figure><img src="/files/MkWlOz1K7CLmCvmq0Xk0" 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/project-and-database-management/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="/files/n6Ixws0Uft34yjqkP9kf" 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. In the project navigation panel or on the [project center](/fabricate/project-and-database-management/project-manager.md), click the options menu for the project.
2. In the options menu, click Clone.

<figure><img src="/files/2hpqq72wzSxyM1YL3uO3" alt=""><figcaption><p>Options menu for the project, with the option to clone the project</p></figcaption></figure>

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

<figure><img src="/files/7c7NCKbWeI3Jsw2xrWKG" 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. In the project navigation panel or on the [project center](/fabricate/project-and-database-management/project-manager.md), click the options menu for the project.
2. In the options menu, click **Delete**.

<figure><img src="/files/2hpqq72wzSxyM1YL3uO3" alt=""><figcaption><p>Options menu for the project, with the option to delete the project</p></figcaption></figure>

3. 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/project-and-database-management/project-manager.md), to delete multiple projects:

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

<figure><img src="/files/n6Ixws0Uft34yjqkP9kf" 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:

```
GET https://docs.tonic.ai/fabricate/project-and-database-management/projects-create-manage.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.