# Changelog

> Part of Tray UI 0.2.0, a design system in plain HTML and CSS (MIT licence). Every page: https://trayui.com/llms.txt

The changelog tells people what changed in the product: one entry per release, the date at the start edge, a title, a tag for the kind of change, and a short list.

## Markup
```html
<ol class="tray-changelog" role="list">
  <li class="tray-release">
    <div class="tray-release__meta">
      <time datetime="2026-11-12">12 November 2026</time>
      <span class="tray-badge">Version 3.4</span>
    </div>
    <div class="tray-release__body">
      <div class="tray-release__tags"><span class="tray-badge tray-badge--accent">New</span></div>
      <h3 class="subtitle">Courier labels in one click</h3>
      <p>Open an order and press Print: the label comes out with the courier's code on it.</p>
      <ul><li>Works with both label sizes.</li><li>Reprints are counted, not charged.</li></ul>
    </div>
  </li>
</ol>
```
The date and version sit in a 11rem column and move above the entry below 40rem. The tag is a Badge: yellow "New" for the one thing to notice, plain "Improved" and "Fixed" for the rest. At most one yellow tag on a screen.

For "What's new" inside the product, put the latest two entries in a Popover behind a megaphone button with a `tray-pip` on it, and link to the full page.

## Accessibility
Each release is an item of an ordered list (with `role="list"`, since Safari stops calling a list without markers a list) with a heading of its own, so a screen reader can move from release to release by heading. Choose the heading level that fits the page; the example uses `<h3>`. Write each date in a `<time>` with a `datetime`. The tags are Badges: the word says the kind of change, and the yellow of "New" only repeats it. In a "What's new" Popover, give the megaphone button an `aria-label` that says there is news, as the bell of the App Shell says "Notifications, 2 unread".

## Do and don't
- Do write the title as what the person can do now.
- Do date every entry and keep them newest first.
- Don't list internal work nobody can see.
- Don't announce what is not out yet.
