> For the complete documentation index, see [llms.txt](https://docs.brainboard.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.brainboard.co/data/data-structure/projects.md).
# Project
### Definition
{% hint style="info" %}
A **project** is a container of environments and architectures to which teams have access with specific permissions.
{% endhint %}
💡Think of a project as an upper level folder.
{% hint style="info" %}
By default, members don't have direct permissions on projects unless the admin grants them access to.
{% endhint %}
***
### Create a new project
To create a new project:
1. Go to the [projects setting page](https://app.brainboard.co/settings/projects).
2. Click on the **`Create project`** button.
3. You will then go through a **project creation wizard** comprising of three steps:
* **First step:** Here, you will set up the **name, description and environments** of the new project.
{% hint style="info" %}
Brainboard creates 5 environments by default: **Production, Staging, Development, Test** and **QA.**
You can also add any custom environment as well
{% endhint %}
{% hint style="warning" %}
The **project name** and at least one **environment** are required to create a new project.
{% endhint %}
* **Second step:** Here, you will need to assign **teams** to **roles**. You can do that by dragging and dropping each team into the corresponding role.
{% hint style="warning" %}
You need to assign at least one team with the *admin* role.
{% endhint %}
* **Third step:** Here, you can view the summary of the new project: *name, description, environment* and the *teams* assigned to this project with their *roles*.
4. Click the **`Create project`** button to save your project details.
Upon clicking the **`Create project`** button, the new project's details will be saved, and you will be navigated to the[ project settings page](https://app.brainboard.co/settings/projects), where you can view the project details as well as edit it.
### View the project's information
To view the information on a specific project:
1. Go to the [projects setting page](https://app.brainboard.co/settings/projects).
2. Click on the **`+`** icon next to the project name, and the project's details will be expanded, such as:
* Name of the project.
* Teams that have access to this project with their respective roles.
* The environments of the project.
Alternatively, you can click on the **`ellipsis icon`** next to the project name, and then select the **`View details`** option from the dropdown menu.
{% hint style="info" %}
Click the **cross ****`x`** icon to collapse the project details view.
{% endhint %}
### Edit project information
To edit the information on a project:
1. Go to the [projects setting page](https://app.brainboard.co/settings/projects).
2. Click on the **`ellipsis icon`** next to the project name, and then select the **`Edit project details`** option from the dropdown menu.
3. You can alter the project *name, description,* and *environments.*
4. Click on the **`Save changes`** button in the top right corner of the **Edit project details** slide-out panel to save the new information.
### Edit project roles
{% hint style="info" %}
By default, the following four types of roles are available for a **Brainboard** project:
* Admin
* Designer
* Operator
* Guest
{% endhint %}
To assign a role to a team:
1. Go to the [projects setting page](https://app.brainboard.co/settings/projects).
2. Click on the **`ellipsis icon`** next to the project name, and then select the **`Assign teams`** option from the dropdown menu.
3. You can assign a role to a team as you did when you created a new project - simple **drag and drop a team** to the specific **role** that you want to assign to it.
4. Click on the **`Update`** button to save the new information about the project.
{% hint style="warning" %}
Only the roles that are predefined for **Projects** on the [Roles page](https://app.brainboard.co/settings/roles) will be available for assignment.
For details, read the [Project Roles and Permissions](/data/data-structure/project-roles-and-permissions.md) article.
{% endhint %}
### Delete project
To delete a project:
1. Go to the [projects setting page](https://app.brainboard.co/settings/projects).
2. Click on the **`ellipsis icon`** next to the project name, and then select the **`Delete project`** option from the dropdown menu.
3. You'll be asked to confirm the deletion. To do so, type the word "**DELETE**" in the input field, and click the **`Yes, delete project button`**.
{% hint style="warning" %}
Once you confirm the deletion action, the project will be permanently deleted.
{% endhint %}
{% hint style="info" %}
If there is only one project in your account, it cannot be deleted since your account needs at least one project.
{% endhint %}
