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

# List & Views

> Browse projects by who owns them, by product area, or as a flat list — switch between list and kanban layouts, and use the AI Roadmap to see themes across active work

The `/projects` page is your project dashboard. You can browse projects three ways and switch the layout independently.

## The Three Views

Use the view toggle at the top of the page.

### Mine (default)

Shows only the projects assigned to you (or where you're the DRI), sorted by recent activity. This is the default when you land on `/projects`, so you immediately see what's on your plate without drilling through areas.

Empty state: **"Nothing assigned to you right now."**

### All

A flat list (or kanban) of every promoted project in the workspace. Use this when you need a workspace-wide read or want to sort across teams.

### Areas

Organizes projects by your product taxonomy. At the root you see top-level domain cards plus an **Unassigned** card; click any card to drill in. The breadcrumb at the top of the page lets you zoom back out.

Inside an area, you see:

* **Children cards** — the sub-areas directly underneath
* **Projects** — every project whose taxonomy path passes through this node, rendered as rows below

**Unassigned** is a pseudo-area that collects projects without an `areaPath` — useful for cleaning up loose ends.

<Info>
  Areas only have content if your workspace has authored a product taxonomy. If you haven't yet, the Areas view will show an empty state.
</Info>

#### Taxonomy vs. Initiatives

When Areas is selected, a second toggle picks how the grouping is rendered:

* **Taxonomy** (default) — the product taxonomy tree you built in [Taxonomy](../Taxonomy/overview)
* **Initiatives** — user-created Projects V2 initiatives (e.g., "Expansion", "Retention", "Conversion")

Click an initiative card to drill into the projects tied to that initiative. Use the back affordance to return to the initiative list.

## Layout: List vs. Kanban

Independent of the view, you can pick how rows render.

### List

A sortable table. Click any column header to sort. Each row shows:

| Column            | What It Shows                                                                                  |
| ----------------- | ---------------------------------------------------------------------------------------------- |
| Title + substatus | Project title with a small real-time substatus chip ("In review", "Ready to merge", "Blocked") |
| Progress          | 0–100% computed from stage                                                                     |
| Priority          | P0 / P1 / P2 / P3 chip                                                                         |
| Status            | Drafting, In progress, In review, Ready to merge, Done, Blocked                                |
| Approval          | Only shows if not yet approved: draft / proposed / approved                                    |
| Blockers          | Red badge with count when blocked                                                              |
| ARR               | Cumulative ARR from linked customer companies (green accent)                                   |
| PRs               | Count of attached PRs                                                                          |
| Signals           | Count of attached signals                                                                      |
| Customers         | Distinct customer companies                                                                    |
| Trend             | 30-day change in signal volume (green = up, red = down)                                        |
| Assignees         | Overlapping avatar stack (max 3, +N more) with provenance badges                               |

### Kanban

Drag-and-drop columns by status. If your workspace has a connected Linear workspace with custom statuses, those statuses appear as additional columns.

## The AI Roadmap Banner

The banner at the top of `/projects` clusters your active and recently shipped projects into themes with a one-sentence narrative.

### Time Range

Pick **Month**, **Quarter**, or **Year** to control the look-back window.

### Two Views

* **Themes** — three-column layout: **Scoping · next up** (amber), **In flight** (primary), **Shipped** (green). Each column lists up to 6 projects with a click-through to detail.
* **Timeline** — a horizontal gantt-style roadmap. Bars represent project duration from created → shipped (or today for in-flight). Scoping-stage projects render as small markers at "today." Swim lanes group by AI themes, product areas, or initiatives (toggle to change).

### Controls

* **Hide shipped** — collapses the shipped column in Themes view
* **Group by** (Timeline view) — AI themes / Product areas / Initiatives
* **Refresh** — regenerates the LLM clustering
* **Collapse** — hides the full banner; shows only the narrative

The banner also surfaces totals: active count, shipped count, and ARR rolled up per stage.

<Tip>
  The AI Roadmap doesn't replace your tracked-item types — it groups by **theme** as inferred from the signals. Two unrelated projects can land in the same theme if they're driven by the same customer demand.
</Tip>

## URL State

The list page persists view, layout, and area in the URL, so anything you can see is shareable.

* `?view=mine` (default) / `?view=all` / `?view=areas`
* `?layout=list` (default) / `?layout=kanban`
* `?group=taxonomy` (default in Areas) / `?group=initiatives`
* `?area=<id>` — drill into a specific taxonomy area (or `__unassigned`)
* `?initiative=<id>` — drill into a Projects V2 initiative

## Live Updates

The list page subscribes to your workspace's tracked-item event stream. When a PR merges, an assignee changes, or a status flips, the list updates without a manual refresh. If the websocket drops, the list falls back to a 60-second poll.