loco-admin-web/specs/designs/13-kbs/list.md

Knowledge Bases List Page

Overview

Card grid list of all knowledge bases.

Follows the layout of specs/designs/10-layout/list.md, only the details are documented in this spec.

Page Name

"Knowledge Bases" for title and breadcrumb

Filters

Row	Mode	Values	Default	Extra
Mode	Single	All, External, Managed	All	shows count badge
Tags	Multi	the tags present across all KBs	None	row hidden when no tags exist

Card Anatomy

Cards are taller than the model and tool cards (256 px) to leave room for a documents preview.

┌─────────────────────────────────────────────────────────────┐
│ [icon]  KB Name                                  [status]   │
│                                                             │
│ Description text, clamped to three lines…                   │
│                                                             │
│ [tag] [tag]                                                 │
│                                                             │
│  📄 doc-one.pdf         📄 doc-two.md                       │
│  📄 doc-three.txt       📄 doc-four.pdf                     │
│  📄 doc-five.md         📄 +N more                          │
└─────────────────────────────────────────────────────────────┘

The card is clickable as a whole and links to /workloads/kbs/[id]. When onselect is provided (e.g. inside a KB picker), the card renders as a button instead and calls the handler on click / Enter.

Header

• Small icon (size 36)
• KB name (line-clamp-2 if long)
• Status badge (right, when set)

Body

• Description, clamped to three lines

Tags

• tag chips (only rendered when there are tags)

Documents Preview

2-column grid in the footer, up to 5 documents listed with a FileIcon. Any further documents collapse into a +N more item.

Empty States

No knowledge bases at all:

DatabaseIcon (muted)
"No knowledge bases yet."
[New Knowledge Base button]

No match:

DatabaseIcon (muted)
"No knowledge bases match your filters."
[Clear filters link]