alepha@docs:~/lore/docs/guides$
cat 6-project-dashboard.md | pretty
6 min read
Last commit:

#The project dashboard

Every project has a Dashboard, and it is what you land on when you open the project. This page calls it the board; it is not the Kanban page of Quests. It holds cards: each one is a number, and each number is a link to the page it came from.

#The board belongs to the project, not to you

This is the first thing to know, because it is the thing people are surprised by. There is one board per project and everybody in the project sees the same one. Add a card and it appears for your colleagues; remove one and it goes for them too.

That is deliberate. A private board about a shared project is a preference rather than a view of the project, and "look at the dashboard" has to mean something between two people.

There is no personal layout. If two of you want different cards, the board holds both. Ten tiles is not a crowd.

#It opens empty, and you fill it

A new project's board has nothing on it. That is not a bug, not a loading state, and not a project that is misconfigured.

Nothing seeds it because the cards worth having need a target only you can choose: an epic card needs an epic, a release card needs a release, a tag card needs a tag. A board of two cards nobody picked is not better than a board of none.

Use Add card, pick a metric, and point it at the thing you care about.

#Who may change it

Editing the board needs the project:update permission.

In the ranks a project is created with, that means the owner and anyone with the Admin rank. A Contributor or a Viewer reads the board and cannot change it: no Add button, no card menu, no dragging.

If you want Contributors curating the board in your project, tick project:update for that rank in Settings ▸ Members ▸ Ranks. It is a checkbox in your own rank matrix rather than something Lore decides for you.

#The cards

Which cards you can add depends on the project's capabilities and your permissions, and most take a scope: a project, an epic, a release, a tag or an app. Flow cards read the same figures as Reports and link to the tab that explains them.

The project

Card What it shows
Needs you Held, stale and overdue work, crashes and feedback, in one list
Activity The project's last recorded writes
Momentum Recorded writes per day, as bars
Note Markdown you write, for everyone who reads the board

Quests

Card What it shows
Active quests Open quests in the project: to do plus in progress
On hold How many of those are parked, waiting on something
Epic progress How far one epic has got
Release progress How far one release has got
Tag completion Completed over total for one quest tag
Your quests What the reader has accepted and not finished
Reminders due Your reminders in the next seven days
Due soon Open quests due in the next seven days
Recently shipped The last completions, with their message

Flow

Card What it shows
Burn-up Created against completed, cumulative
Completed per week The last eight weeks, as bars
Completed this week Against the week before
Cycle time Median hours from accepted to completed
Quests by area By area, tag or priority
Board Open quests per kanban column

Planning

Card What it shows
Release The release this project is heading for, and its pace
Ready to publish Open releases whose every quest is done
Epics in flight Epics in progress, with their bar
Draft epics Epics still being specified

Folios

Card What it shows
Pinned The first pinned folio, its summary
Recently edited The last folios edited, by whom and when
New folios Folios created in the window
Folios by directory How many folios each top-level directory holds

Apps and feedback

Card What it shows
App health One pill per copy: its last deploy, and whether it reports
Errors Occurrences per day, deployments as rules
Coverage Line coverage over the recorded runs
Open blights For the project or a list of apps
Unique visitors Per app, yesterday against the day before
Untriaged feedback Reports waiting for triage

On hold is a subset of Active quests. Both count the same set of open quests, so "Quests 12 / On hold 3" reads as three of the twelve being stuck.

A quest carrying two tags counts in both. So tag cards do not add up to the project's quest count, and they are not meant to: a tag says what kind of work something is, and a quest can be two kinds at once.

#⚠️ What the two progress cards divide by

Both show completed over total, with shelved quests excluded from the total. A quest you decided against leaves the numerator and the denominator together, so an epic can reach 100% with declined work left in it.

This differs from the tick bar on the Epics list, which draws all four buckets - done, in progress, open and shelved - over the full total. So the same epic can read 8 of 10 on its card and show ten ticks on the list, and neither is wrong. The card says what it divided by, under the number.

#A card can point at something that is finished

An epic that has completed, or a release that has been published, keeps its card. Both are done by definition, so the number is settled rather than stale, and the card says which. To point it somewhere else, use Change scope in the card's menu.

#There is no Reset

Not on a project board and not on your own. A board this small has no layout worth an undo, and on a shared one a Reset button is one person discarding everybody's configuration in a click.

Remove cards one at a time. That is also how they got there.

#Where Activity went

Activity used to be the project root. It is now at /activity and everything about it is unchanged - the same feed, the same filters, the same sidebar entry, one path down.