Skip to main content
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

​
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
ElementDescription
Workspaces iconTop icon - opens the Workspaces view for coding agents
Project iconsSquare buttons showing project abbreviations (e.g., “VI” for vibe-kanban)
+ buttonCreate 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
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
FieldDescription
NameA clear name for your project (e.g., “Mobile App”, “Q1 Marketing”)
ColourClick 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 four default status columns:
StatusPurpose
BacklogIssues waiting to be worked on
To DoIssues ready to start
In ProgressIssues currently being worked on
DoneCompleted issues
Project kanban board showing columns and issues
You can customise these statuses - rename them, change colours, add new ones, or hide ones you don’t use. See Customising Your Board for details.

​
Project Settings

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

​
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
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 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:
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
4

Click Delete

Select Delete from the menu and confirm when prompted.
Dropdown menu with Delete option
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.

​
Best Practices

One project per initiative

Create separate projects for distinct initiatives rather than putting everything in one project. This keeps your boards focused and manageable.

Use descriptive names

Choose project names that clearly describe what the project is about. “Mobile App v2” is better than “Project A”.

Consistent status columns

Try to use similar status columns across projects so team members can switch between projects without confusion.

Archive completed work

Once issues are done, you can hide the Done column or create an Archive status to keep your board clean.