> ## 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.
## 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.
### 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.
Hover over any project icon to see the full project name in a tooltip.
## Creating a Project
Sign in and select your organisation from the sidebar or organisation switcher.
Click the **+ New Project** button in the sidebar or on the projects page.
Fill in the project information:
| 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 |
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 |
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).
You can customise these statuses - rename them, change colours, add new ones, or hide ones you don't use. See [Customising Your Board](/cloud/customisation) for details.
## Project Settings
Access project settings by clicking the gear icon () next to the project name.
### 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**
The colour appears in the sidebar and helps you quickly identify projects.
You can also manage projects from **Settings** → **Remote Projects**. See [Remote Projects Settings](/settings/remote-projects) 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
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**:
Go to **Settings** and select **Remote Projects** from the sidebar.
Select the organisation and locate the project you want to delete.
Hover over the project and click the **⋯** (three dots) menu.
Select **Delete** from the menu and confirm when prompted.
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](/settings/remote-projects).
## Best Practices
Create separate projects for distinct initiatives rather than putting everything in one project. This keeps your boards focused and manageable.
Choose project names that clearly describe what the project is about. "Mobile App v2" is better than "Project A".
Try to use similar status columns across projects so team members can switch between projects without confusion.
Once issues are done, you can hide the Done column or create an Archive status to keep your board clean.
## Related Documentation
* [Issues](/cloud/issues) - Creating and managing issues
* [Kanban Board](/cloud/kanban-board) - Using the board interface
* [Customising Your Board](/cloud/customisation) - Configuring columns and display settings
* [Remote Projects Settings](/settings/remote-projects) - Managing projects from Settings