BuildBetter Docs

List & Views

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:

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.

Taxonomy vs. Initiatives

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

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

Controls

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.

URL State

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

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.