TheDocumentation Index
Fetch the complete documentation index at: https://docs.buildbetter.ai/llms.txt
Use this file to discover all available pages before exploring further.
/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
areaPath — useful for cleaning up loose ends.
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:- Taxonomy (default) — the product taxonomy tree you built in Taxonomy
- Initiatives — user-created Projects V2 initiatives (e.g., “Expansion”, “Retention”, “Conversion”)
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
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