FORMA Docs

Changelog feed

Release notes you can filter, open in place, and scroll through month by month.

import { ChangelogFeed } from "@/forma/arc/blocks/changelog-feed/changelog-feed";
Base

In FORMA

  • Liegt in kit/arc/blocks/changelog-feed und ist über @/forma/arc/blocks/changelog-feed/changelog-feed erreichbar.
  • Farbe, Ecken, Höhen, Abstände, Tiefe, Schrift und Tempo kommen aus der Richtung (core/arc-bridge.ts); Arc behält Verhalten, Tastatur und Federn.

When to use

  • A product changelog or release notes page grouped by month.
  • Release notes with type filters such as features, fixes, and improvements.
  • Changelogs that should offer an email subscribe action in the header.

When not to use

  • Use timeline for a short vertical list of events without filters.
  • Use accordion for plain expandable content that is not dated.

Usage

import { ChangelogFeed } from "@/forma/arc/blocks/changelog-feed/changelog-feed";

export default function ChangelogPage() {
  return (
    <main>
      <ChangelogFeed />
    </main>
  );
}

API reference

ChangelogFeed

Release notes grouped by month, with type filter chips, expandable entries with media, a month jump nav, and an inline subscribe form. Entries, images, and the webhook snippet are sample data.

No props.

Keyboard interactions

KeysAction
EscapeCancels the subscribe form and returns to the Subscribe button.

Accessibility

  • Each entry row is a button with aria-expanded and aria-controls pointing at its detail panel.
  • Filter chips are toggle buttons with aria-pressed, and the visible count is announced in a polite status region.
  • The month nav marks the current month with aria-current, and the scroll area is focusable with an aria-label.

Motion

  • Entries open in place on a spring while the chevron rotates; the month label slides in the scroll direction.
  • The subscribe control morphs from button to form to a drawn check with a short blur crossfade.
  • Reduced motion makes these changes instant.

Responsive behavior

  • Below 640px the header stacks, rows move date and type above the text, and the scroller drops from 560px to 520px.
  • Below 480px month counts and the shown count are hidden so the month nav fits on one line.
  • Hover styles apply only on hover-capable fine pointers.

Performance

  • The feed scrolls inside a fixed-height area; entries are not virtualized, so paginate or load older months on demand.
  • Scroll tracking for the month bar is batched to one requestAnimationFrame, and a ResizeObserver resyncs it on resize.

Notes for AI

  • Use for a product changelog or release notes page.
  • Replace the entries array and the imported sample images with data from your release notes source or CMS.
  • The subscribe submit only changes local state; post the email to your mailing list provider.

Guidance for AI tools

Blocks are complete, self-contained screens with sample data. Replace the sample data and connect the callbacks described above. Follow the declared prop types and do not invent props. Keep keyboard access, reduced motion support, and both light and dark themes intact when adapting it.

Full library index: https://uiarc.dev/llms.txt

Komponente und Text: Arc UI (MIT, uiarc.dev), angepasst für FORMA.