Projects

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

<Frame> </Frame>

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.

<Frame> </Frame>

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.

<Frame> </Frame>

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

Creating a Project

<Steps> <Step title="Open your organisation"> Sign in and select your organisation from the sidebar or organisation switcher. </Step> <Step title="Click Create Project"> Click the **+ New Project** button in the sidebar or on the projects page. </Step> <Step title="Enter project details"> Fill in the project information: <Frame> </Frame>

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

</Step> <Step title="Click Create"> Click **Create Project** to create your project. You'll be taken to your new project's kanban board. </Step> </Steps>

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

<Info> 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). </Info> <Frame> </Frame>

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 (<Icon icon="gear" />) next to the project name.

<Frame> </Frame>

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

<Frame> </Frame>

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](/settings/remote-projects) for more details. </Tip>

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. </Warning>

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

<Steps> <Step title="Open Remote Projects settings"> Go to **Settings** and select **Remote Projects** from the sidebar. </Step> <Step title="Find the project"> Select the organisation and locate the project you want to delete. </Step> <Step title="Open the menu"> Hover over the project and click the **⋯** (three dots) menu. <Frame> </Frame> </Step> <Step title="Click Delete"> Select **Delete** from the menu and confirm when prompted. <Frame> </Frame> </Step> </Steps> <Info> Before deleting, consider whether you might need any of the issues or their history. There's no way to recover a deleted project. </Info>

For more details on managing projects, see Remote Projects Settings.

Best Practices

<CardGroup cols={2}> <Card title="One project per initiative" icon="folder"> Create separate projects for distinct initiatives rather than putting everything in one project. This keeps your boards focused and manageable. </Card> <Card title="Use descriptive names" icon="tag"> Choose project names that clearly describe what the project is about. "Mobile App v2" is better than "Project A". </Card> <Card title="Consistent status columns" icon="columns"> Try to use similar status columns across projects so team members can switch between projects without confusion. </Card> <Card title="Archive completed work" icon="box-archive"> Once issues are done, you can hide the Done column or create an Archive status to keep your board clean. </Card> </CardGroup>

Related Documentation

• Issues - Creating and managing issues
• Kanban Board - Using the board interface
• Customising Your Board - Configuring columns and display settings
• Remote Projects Settings - Managing projects from Settings