Build system
Deployment requires review
Production approval is still unresolved.
<forma-feed-item>
Compact chronological item with explicit identity, state, metadata, and owned actions.
<forma-feed-item>patterns/feed-item.htmlA feed item is one entry in an activity or notification stream: where it came from, what it is about, its state and time, a one-line summary, and the actions that belong to it. Forma lays it out as a two-column grid with identity on the start side and status/time on the end side, and gives the summary and actions full rows beneath. The application decides what appears in the feed, its order, what the state means and which actions are legal.
minmax(0, 1fr) auto: identity on the start side, meta (status and time) on the end side..forma-feed-item__summary and .forma-feed-item__actions span both columns.The smallest correct markup: the canonical pattern from patterns/feed-item.html inside its public tag. Copy this first, then adapt labels, names and state.
Rendered from the canonical pattern file.
Static specimen. Its buttons stand for application actions that the consuming application implements; this script-free documentation does not perform them. Its controls are shown for their markup and appearance and cannot be operated here.
Build system
Production approval is still unresolved.
<forma-feed-item class="forma-component-tag">
<article class="forma-feed-item" aria-labelledby="feed-item-title">
<div class="forma-feed-item__primary">
<p class="forma-feed-item__source">Build system</p>
<h2 id="feed-item-title">Deployment requires review</h2>
</div>
<div class="forma-feed-item__meta">
<span class="forma-status-lozenge" data-state="warning">Needs review</span>
<time datetime="2026-09-25T18:30:00Z">18:30</time>
</div>
<p class="forma-feed-item__summary">Production approval is still unresolved.</p>
<div class="forma-feed-item__actions"><button type="button">Review</button></div>
</article>
</forma-feed-item>
Click or tap the code once to select all of it, then copy.
A comment mention with two owned actions. The buttons name the item they act on, because many feed items can carry a Reply button.
Static specimen. Its buttons stand for application actions that the consuming application implements; this script-free documentation does not perform them. Its controls are shown for their markup and appearance and cannot be operated here.
Comment on INV-1042
“Can you confirm the revised payment terms before I send this to Acme?”
<forma-feed-item class="forma-component-tag">
<article class="forma-feed-item" aria-labelledby="feed-item-mention-with-actions-title">
<div class="forma-feed-item__primary">
<p>Comment on INV-1042</p>
<h2 id="feed-item-mention-with-actions-title">Priya Raman mentioned you</h2>
</div>
<div class="forma-feed-item__meta">
<span class="forma-status-lozenge">Unread</span>
<time datetime="2026-09-29T09:41:00Z">09:41</time>
</div>
<p class="forma-feed-item__summary">“Can you confirm the revised payment terms before I send this to Acme?”</p>
<div class="forma-feed-item__actions forma-cluster">
<button type="button" aria-label="Reply to Priya Raman on INV-1042">Reply</button>
<button type="button" aria-label="Mark Priya Raman's mention as read">Mark as read</button>
</div>
</article>
</forma-feed-item>
Click or tap the code once to select all of it, then copy.
An item that no longer needs anything. The application renders no actions region, and the state reads Resolved in words.
Monitoring
p95 latency returned below 400 ms after the cache node was replaced.
<forma-feed-item class="forma-component-tag">
<article class="forma-feed-item" aria-labelledby="feed-item-resolved-without-actions-title">
<div class="forma-feed-item__primary">
<p>Monitoring</p>
<h2 id="feed-item-resolved-without-actions-title">Checkout latency back within limits</h2>
</div>
<div class="forma-feed-item__meta">
<span class="forma-status-lozenge" data-state="ok">Resolved</span>
<time datetime="2026-09-29T06:12:00Z">06:12</time>
</div>
<p class="forma-feed-item__summary">p95 latency returned below 400 ms after the cache node was replaced.</p>
</article>
</forma-feed-item>
Click or tap the code once to select all of it, then copy.
Several items stacked in a labelled section. A long, translated title wraps in the start column while the meta column keeps its natural width.
Static specimen. Its buttons stand for application actions that the consuming application implements; this script-free documentation does not perform them. Its controls are shown for their markup and appearance and cannot be operated here.
Système de facturation
Build system
<forma-feed-item class="forma-component-tag">
<section class="forma-stack" data-density="standard" aria-label="Recent activity">
<article class="forma-feed-item" lang="fr" aria-labelledby="feed-item-feed-list-long-title-first">
<div class="forma-feed-item__primary">
<p>Système de facturation</p>
<h2 id="feed-item-feed-list-long-title-first">La validation de la publication du rapport trimestriel nécessite une revue manuelle</h2>
</div>
<div class="forma-feed-item__meta">
<span class="forma-status-lozenge" data-state="attention">À vérifier</span>
<time datetime="2026-09-29T10:02:00Z">10:02</time>
</div>
<div class="forma-feed-item__actions"><button type="button" aria-label="Examiner la validation du rapport trimestriel">Examiner</button></div>
</article>
<article class="forma-feed-item" aria-labelledby="feed-item-feed-list-long-title-second">
<div class="forma-feed-item__primary">
<p>Build system</p>
<h2 id="feed-item-feed-list-long-title-second">Nightly build passed</h2>
</div>
<div class="forma-feed-item__meta">
<span class="forma-status-lozenge" data-state="ok">Passed</span>
<time datetime="2026-09-29T02:00:00Z">02:00</time>
</div>
</article>
</section>
</forma-feed-item>
Click or tap the code once to select all of it, then copy.
Each mobile example renders in its own document inside a real narrow viewport, so Forma's media and container queries run exactly as they would on a phone. Choose a width to compare.
A blocked deployment item at phone width. Status and time move under the title; the summary and action follow in reading order.
Static specimen. Its buttons stand for application actions that the consuming application implements; this script-free documentation does not perform them. Its controls are shown for their markup and appearance and cannot be operated here.
minmax(0, 1fr) column and .forma-feed-item__meta aligns to the start under the title.<forma-feed-item class="forma-component-tag">
<article class="forma-feed-item" aria-labelledby="feed-item-mobile-feed-item-title">
<div class="forma-feed-item__primary">
<p>Deployments</p>
<h2 id="feed-item-mobile-feed-item-title">Release rel-2026.09.29 is blocked</h2>
</div>
<div class="forma-feed-item__meta">
<span class="forma-status-lozenge" data-state="blocked">Blocked</span>
<time datetime="2026-09-29T11:20:00Z">11:20</time>
</div>
<p class="forma-feed-item__summary">Two required checks have not reported.</p>
<div class="forma-feed-item__actions"><button type="button" aria-label="View blocked checks for rel-2026.09.29">View checks</button></div>
</article>
</forma-feed-item>
Click or tap the code once to select all of it, then copy.
The canonical pattern in a true 320px viewport, the minimum width every Forma component must support without page-level horizontal scrolling.
Static specimen. Its buttons stand for application actions that the consuming application implements; this script-free documentation does not perform them. Its controls are shown for their markup and appearance and cannot be operated here.
Forma components have no JavaScript API. Their public contract is the markup: native elements and attributes you write, and the CSS hooks below. The CSS hook table is generated from the built stylesheet, so it always matches the shipped implementation.
| Attribute | On | Values | Default | Description |
|---|---|---|---|---|
aria-labelledby | article.forma-feed-item | id of the item heading | — | Names the article by its title so it can be found in a list of articles. |
datetime | time | ISO date-time | — | Machine-readable time of the item. |
aria-label | action button | string | — | Names the item an action applies to when the visible label is generic. |
type | button | button | — | Actions are native buttons that the application wires to its own handlers. |
| Hook | Kind | Values or default | Description |
|---|---|---|---|
.forma-feed-item | Block class | — | The item root, usually an article. Two-column grid; one column at 30rem and below. |
.forma-feed-item__actions | Element class | — | Optional actions row spanning the full width. |
.forma-feed-item__meta | Element class | — | End column: status and time in a wrapping row, end-aligned (start-aligned on phones). |
.forma-feed-item__primary | Element class | — | Start column: source line and title. Margins on its h2 and p are removed. |
.forma-feed-item__summary | Element class | — | Optional one-line summary spanning the full width. |
| Keys | Result |
|---|---|
| Tab | Moves to each action button in the item. The item itself is not focusable. |
| Enter / Space | Activates a focused action button (native). |
| Event | Description |
|---|---|
click | Native click on action buttons; the application performs the action and updates or removes the item. |
Not a form control.
| State | How it is expressed | Presentation |
|---|---|---|
| With actions | .forma-feed-item__actions present | Actions row below the summary. |
| No actions | actions element omitted | The item ends after its summary or meta. |
| Item state | Status lozenge text in .forma-feed-item__meta | Unread, Resolved, Blocked and so on are stated in words by the application. |
| Stacked | viewport ≤ 30rem | Single column with meta aligned to the start. |
minmax(0, 1fr)), so long content does not overflow.aria-labelledby.datetime.Generated fault-injection specimens expose content, spacing, color-cue, and reduced-effective-contrast risks. They screen presentation robustness as engineering screens without claiming human-subject validation.