Forum and discussion topics: each TopicRow has the title (the whole row is a link), category and tags, reply and view counts, and who posted last and when — with pinned, solved, locked and unread states. TopicList adds column heads on wide containers and an empty state; sorting, filtering and paging stay in the app.
What's your backup routine for a small home server? Solved New
Hardware#backup#storage
23 replies
Last post by Mira Kaya, 12 min. ago
Installation
The whole kit as one package — get updates by bumping the version. Add the styles to globals.css: @import "@vamos-ui/react/styles.css";
Usage
import { TopicList, TopicRow } from "@vamos-ui/react";
<TopicList aria-label="Latest topics" topics={topics} />
<ul>
<li><TopicRow title="Quiet fans for a compact case" href="/t/88" replies={7} views={402} lastPost={{ name: "Jonas Ek", at: post.createdAt }} /></li>
</ul>Relative times render as a date on the server and switch to "3 hr. ago" after hydration unless now is passed.
Category and tag links sit above the row link, so each stays its own tab stop.
Examples
Sorting and an empty state
The app sorts and filters; ToggleGroup drives it. empty replaces the list when nothing matches.
What's your backup routine for a small home server? Solved New
Hardware#backup#storage
23 replies
Last post by Mira Kaya, 12 min. ago
TopicRow on its own
In a narrow sidebar the row folds: counts at the end, last post underneath. tagHref turns tags into links.
API
TopicList
| Prop | Type | Default |
|---|---|---|
topicsRows: TopicRow props plus an id. | TopicListItem[] | — |
aria-label / aria-labelledbyName of the list. | string | — |
showHeaderColumn heads on wide containers. | boolean | true |
emptyShown when topics is empty. | ReactNode | "No topics yet." |
headingLevelLevel of every title. | 2 | 3 | 4 | 5 | 3 |
nowFixed epoch ms for relative times (static pages, tests). | number | — |
TopicRow
| Prop | Type | Default |
|---|---|---|
title / hrefThe topic and its page; the link covers the row. | string | — |
excerptOne line of the first post (wider containers). | string | — |
categoryBoard or category. | { label; href? } | — |
tags / tagHrefShown as #tag; links with tagHref. | string[] / (tag) => string | — |
replies / viewsCounts, compact on screen (1.8K), spoken in full. | number | — |
lastPostAvatar, name and relative time of the latest post. | { name; src?; at } | — |
pinned / solved / locked / unreadStates: pin and lock icons, Solved and New badges. | boolean | — |
labelsDictionary namespace "topicList" (en, tr, de, fr, es, ar built in). | Partial<TopicListLabels> | — |