Projects

Projects are the top-level organizational unit in VibeFlow. Each project corresponds to a software repository or major workstream.

Creating a Project

1. Navigate to VibeFlow in the sidebar
2. Click + New Project
3. Fill in:
   • Name — A short identifier (e.g., "my-app", "api-service")
   • Description — What the project is about
   • Default Branch — The primary git branch (usually main)
4. Click Create

Project Status Workflow

Projects follow the same status workflow as all VibeFlow entities:

in_review → planning → ready_to_implement → implementing → done

• in_review — Initial state; project scope is being reviewed
• planning — Architecture and work breakdown in progress
• ready_to_implement — Work items created and ready for agents
• implementing — Agents are actively working on features
• done — All features and issues completed

Project status cascades automatically: when all features and issues in a project are done, the project transitions to done.

Project Settings

Default Branch

The default git branch for new work items. When creating todos or issues without specifying a branch, they inherit this branch.

Privacy

• Public — All organization members can view and work on the project
• Private — Only the project creator and explicitly granted users can access

Persona Theme

Choose a visual theme for the project UI:

• Professional — Clean, corporate-friendly design
• Modern Graphic Novel — Expressive, visual design

Allowed Embed Domains

If you share project dashboards publicly, specify which domains can embed them.

Project Statistics

Each project displays key metrics:

• Features — Total and completed count
• Todos — Total and completed count
• Issues — Total and completed count
• Lines Changed — Total lines added and deleted across all commits
• Work Time — Estimated human-equivalent hours based on completed work

Archiving and Deleting

• Archive — Hide the project from the main list without deleting data. Archived projects can be unarchived later.
• Delete — Permanently remove the project and all associated data. This action cannot be undone.

Default Branch Configuration

The project's default branch determines which git branch new work items target by default. You can change it in the project settings:

1. Open the project
2. Go to the Setup tab
3. Update the Default Branch field

Changing the default branch cascades to all work items that still target the old branch.

When importing from Jira, the import wizard lets you override the target branch per import batch.

Jira Project Mapping

If your organization has Jira connected, you can import Jira tickets into any VibeFlow project. The import wizard is accessible from the Import button in the project toolbar. Epics are automatically mapped to VibeFlow features (matched by name or created new). See Integrations for details.

Summary Page

The Summary tab provides a dashboard overview of the project:

KPI Tiles

Six top-level metrics tiles at the top of the page:

• Features — Done count / total count
• Todos — Done count / total count
• Issues — Done count / total count
• Work Time — Total agent work time (e.g., "1d 12h")
• Lines — Lines added (green) and deleted (red)
• Human Est. — Estimated equivalent human development time

Clicking the Features, Todos, or Issues tiles navigates to the corresponding tab.

Dashboard Tiles

Below the KPI row, the summary includes:

• Status overview — Donut chart of Done / In Progress / To Do
• Recent activity — Latest work item updates with timestamps
• Priority breakdown — Distribution across high / medium / low
• Types of work — Feature / Todo / Issue distribution
• Team workload — Per-agent work distribution by branch
• Feature progress — Stacked bar chart per feature
• Top tags — Tag keys and values used across the project

Kanban Board

Each project has a Kanban board view showing all work items (todos and issues) organized by status in swimlane columns. You can also view a Global Kanban across all projects from the main VibeFlow page.