> ## Documentation Index
> Fetch the complete documentation index at: https://vibekanban.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Projects

> Create and manage projects to organise your work

Projects are where your work lives. Each project contains a kanban board with issues, statuses, and tags that help you organise and track progress.

![Project kanban board showing columns and issues](https://mintcdn.com/vibekanban/TDM0xx2duuZqyvY7/images/cloud/project-kanban-board.png?fit=max\&auto=format\&n=TDM0xx2duuZqyvY7\&q=85\&s=d30b4023136defc030f6c1b20e80abe6)

## What is a Project?

A **project** is a container for related work within your organisation. Think of it as a dedicated space for a specific initiative, product, or team goal.

Each project has:

* **Issues** - Individual work items (bugs, features, tasks)
* **Statuses** - Columns on your kanban board (To Do, In Progress, Done, etc.)
* **Tags** - Labels for categorising issues
* **Team access** - All organisation members can view and work on project issues

## Project Sidebar

The left sidebar provides quick access to your projects and workspaces.

![Project sidebar showing Workspaces icon, project icons, and add button](https://mintcdn.com/vibekanban/TDM0xx2duuZqyvY7/images/cloud/sidebar-workspaces.png?fit=max\&auto=format\&n=TDM0xx2duuZqyvY7\&q=85\&s=27c9ce9f65dc70dc29df5036388ef46a)

### Sidebar Elements

| Element | Description |
| - | - |
| **Workspaces icon** | Top icon - opens the Workspaces view for coding agents |
| **Project icons** | Square buttons showing project abbreviations (e.g., "VI" for vibe-kanban) |
| **+ button** | Create a new project |

### Project Icons

Each project appears as a square button with a two-letter abbreviation of the project name. The currently selected project is highlighted.

![Hovering over project icon shows full project name](https://mintcdn.com/vibekanban/TDM0xx2duuZqyvY7/images/cloud/sidebar-project-tooltip.png?fit=max\&auto=format\&n=TDM0xx2duuZqyvY7\&q=85\&s=f34b8530047635ce0a8eaef5be9befe7)

Hover over any project icon to see the full project name in a tooltip.

## Creating a Project

**1. Open your organisation**

Sign in and select your organisation from the sidebar or organisation switcher.

**2. Click Create Project**

Click the **+ New Project** button in the sidebar or on the projects page.

**3. Enter project details**

Fill in the project information:

![Create Project dialog with name and colour fields](https://mintcdn.com/vibekanban/TDM0xx2duuZqyvY7/images/cloud/create-project-dialog.png?fit=max\&auto=format\&n=TDM0xx2duuZqyvY7\&q=85\&s=73a9bd39aa4edc315adb18af1ec31663)

| Field | Description |
| - | - |
| **Name** | A clear name for your project (e.g., "Mobile App", "Q1 Marketing") |
| **Colour** | Click the colour swatch to choose a colour for this project |

**4. Click Create**

Click **Create Project** to create your project. You'll be taken to your new project's kanban board.

## Default Statuses

New projects come with six default status columns:

| Status | Purpose | Visible by Default |
| - | - | - |
| **Backlog** | Ideas and future work | Hidden |
| **To do** | Issues ready to start | ✓ |
| **In progress** | Issues currently being worked on | ✓ |
| **In review** | Waiting for code review | ✓ |
| **Done** | Completed issues | ✓ |
| **Cancelled** | Issues that won't be done | Hidden |

> [!NOTE]
>
> Hidden statuses don't appear as columns on the board, but you can still access issues in them via the status tabs (e.g., "Backlog" or "Cancelled" tabs).

![Project kanban board showing columns and issues](https://mintcdn.com/vibekanban/TDM0xx2duuZqyvY7/images/cloud/project-kanban-board.png?fit=max\&auto=format\&n=TDM0xx2duuZqyvY7\&q=85\&s=d30b4023136defc030f6c1b20e80abe6)

You can customise these statuses - rename them, change colours, add new ones, or hide ones you don't use. See [Customising Your Board](https://vibekanban.com/docs/cloud/customisation.md) for details.

## Project Settings

Access project settings by clicking the gear icon () next to the project name.

![Project header showing settings gear icon](https://mintcdn.com/vibekanban/TDM0xx2duuZqyvY7/images/cloud/project-settings-icon.png?fit=max\&auto=format\&n=TDM0xx2duuZqyvY7\&q=85\&s=8c6d5d7f19f068c33a40dd2ca04940e0)

### Renaming a Project

1. Open project settings
2. Edit the **Project name** field
3. Click **Save**

### Changing Project Colour

1. Open project settings
2. Click the colour selector
3. Choose a new colour
4. Click **Save**

![Edit project form with name and colour picker](https://mintcdn.com/vibekanban/TDM0xx2duuZqyvY7/images/cloud/edit-project-form.png?fit=max\&auto=format\&n=TDM0xx2duuZqyvY7\&q=85\&s=905d858cd5141b45c9c483bc55735efc)

The colour appears in the sidebar and helps you quickly identify projects.

> [!TIP]
>
> You can also manage projects from **Settings** → **Remote Projects**. See [Remote Projects Settings](https://vibekanban.com/docs/settings/remote-projects.md) for more details.

## Switching Between Projects

You have several ways to switch projects:

**From the sidebar:**

* Click any project name in the sidebar to open it

**From the project dropdown:**

* Click the current project name in the header
* Select a different project from the dropdown

## Deleting a Project

> [!WARNING]
>
> Deleting a project is permanent and cannot be undone. All issues, comments, and data within the project will be deleted.

To delete a project, go to **Settings** → **Remote Projects**:

**1. Open Remote Projects settings**

Go to **Settings** and select **Remote Projects** from the sidebar.

**2. Find the project**

Select the organisation and locate the project you want to delete.

**3. Open the menu**

Hover over the project and click the **⋯** (three dots) menu.

![Project row showing three-dots menu button](https://mintcdn.com/vibekanban/TDM0xx2duuZqyvY7/images/cloud/project-menu-button.png?fit=max\&auto=format\&n=TDM0xx2duuZqyvY7\&q=85\&s=07bd93d185e93bf658fd986a63d41599)

**4. Click Delete**

Select **Delete** from the menu and confirm when prompted.

![Dropdown menu with Delete option](https://mintcdn.com/vibekanban/TDM0xx2duuZqyvY7/images/cloud/project-delete-menu.png?fit=max\&auto=format\&n=TDM0xx2duuZqyvY7\&q=85\&s=b973700b87735228247a41c290c11180)

> [!NOTE]
>
> Before deleting, consider whether you might need any of the issues or their history. There's no way to recover a deleted project.

For more details on managing projects, see [Remote Projects Settings](https://vibekanban.com/docs/settings/remote-projects.md).

## Best Practices

> [card] One project per initiative
>
> Create separate projects for distinct initiatives rather than putting everything in one project. This keeps your boards focused and manageable.

> [card] Use descriptive names
>
> Choose project names that clearly describe what the project is about. "Mobile App v2" is better than "Project A".

> [card] Consistent status columns
>
> Try to use similar status columns across projects so team members can switch between projects without confusion.

> [card] Archive completed work
>
> Once issues are done, you can hide the Done column or create an Archive status to keep your board clean.

## Related Documentation

* [Issues](https://vibekanban.com/docs/cloud/issues.md) - Creating and managing issues
* [Kanban Board](https://vibekanban.com/docs/cloud/kanban-board.md) - Using the board interface
* [Customising Your Board](https://vibekanban.com/docs/cloud/customisation.md) - Configuring columns and display settings
* [Remote Projects Settings](https://vibekanban.com/docs/settings/remote-projects.md) - Managing projects from Settings


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.