History

Changelog

Every release of @comitor/ui, what changed in it, and what you have to change to move up. This is the canonical record — the package’s README points here rather than repeating it. The rest of this site documents the newest release.

Versioning changed at 1.0.0. From 1.0.0 on this is ordinary SemVer: breaking changes ship in a major bump, so an app pinning ^1.0.0 can update without reading this page first. The 0.x rule — breaking changes in a minor bump — explains only the entries below it.

Changed

AppLauncher's tile icon well is no longer a bg-app-accent fill; it is an IconAvatar with seed={app.id}. The old accent table made every app wait to be hand-assigned a colour, so the sixth product either collided with another or sat colourless until someone edited the table — now a new app has a colour the moment it exists, and the same colour in an email, on a canvas or in a PDF, because getAvatarToneColors reads the same tone table. AppDescriptor gains tone?: string — one name from AVATAR_TONE_NAMES — to pick that colour by hand when the derived one is not the one you want.
accent, accentInk and accentForeground on AppDescriptor are deprecated, and `AppLauncher` no longer reads them. They stay in the type so an existing app still compiles, but passing them to the launcher now does nothing. appAccentStyle() is still exported and still correct — an app that draws its own icon tile from the CSS variables keeps using it, and AppShell still applies it to the frame; only AppLauncher stopped calling it.
The locked tile stays grey through a className (bg-muted text-muted-foreground), not through a tone. "Not unlocked yet" is a state, and the tone table is identity colour; borrowing a tone to signal state is a category error. Both classes are solid, so the padlocked icon shows no crossing seam either.

MINOR, and nothing has to change to compile — but an app's colours will move on upgrade even if you touch nothing, on purpose: the launcher now derives each tile's colour from the app id rather than from whatever accent you had assigned. To hold a specific hue, set tone to that tone's name. The migration off the three deprecated props is to drop them and either pass tone or leave it blank for the derived colour.

Added

IconAvatar, the sibling of LetterAvatar. It shares the whole colour layer — the same eight tones, the same hash, the same image / content / sr-only branches — and differs only in what sits in the middle of the tile: an icon rather than an initial. It defaults to a square with rounded corners, the shape of a *thing* (an app, a workspace), instead of the round of a *person*, and rounded="full" reopens the round branch. It replaces the old shape — a hardcoded table of a few accent tokens, where the sixth product either matched another or waited for someone to edit the table — with one where a new app has a colour the moment it exists. The props: name (the accessible name, and the default colour seed); seed (the seed when it differs from the display name — an app must pass its `key`); icon / src (the glyph in the middle, where an uploaded src beats icon); tone (pick one of the eight tone names by hand; an unknown name falls back to the derived colour); and size / rounded (the LetterAvatar size scale, with rounded="full" for the round branch).
AVATAR_TONE_NAMES and the AvatarToneName type are exported alongside it — the tone prop only means anything where the call site can enumerate the set it picks from. `AVATAR_TONES` and `getAvatarToneIndex` stay internal, deliberately: handing out the raw table and the hash is an invitation to rebuild the tone choice app-side, which is exactly how one identity ends up two colours across surfaces.

Fixed

The collapse button at the foot of the sidebar — the last case in the 1.8.3 sweep, and the only one that had to be split rather than recoloured whole. That button carries text when the rail is expanded, so its own colour is held to the 4.5:1 text threshold: measured on --sidebar in light, /60 flattens to #6C6E71 = 4.90:1 ✓, while --muted-foreground is only 3.67:1 ✗. So the button keeps /60 and the icon inside it is now painted separately with a solid token — an icon answers only to the 3:1 threshold.

Two measured warnings sit on IconAvatar. `seed` is not optional for an app: hashing the *translated* name flips 4/6 apps to a new colour when the user switches vi ⇄ en, while hashing the stable key flips 0/6 — so pass the key ("tasks", "crm") and let name stay the accessible string. And eight tones over a catalogue of six or more means collisions: the same measurement gives 5/6 distinct (starter and mes land together), which no different hash can fix — tone is the way out. The glyph is never given an alpha: the tone's background is an alpha tint, but the icon is always a solid ink step, because crossing strokes carrying alpha double-paint at the join — the 1.8.2 lesson.

Format follows Keep a Changelog; versions follow SemVer, strictly from 1.0.0 on and under the 0.x rule above before that.

Changelog

Releases

1.10.07 Sept 2026AppLauncher paints its tile icons with IconAvatar now — each app's colour is derived from its key instead of hand-assigned — and the three AppDescriptor colour props are deprecated.

1.9.07 Sept 2026IconAvatar — an app or workspace icon in a coloured identity tile, sibling to LetterAvatar, its colour derived from the identity and overridable with any of the eight tones — plus the last inherited-alpha icon, at the sidebar collapse button.

1.8.37 Sept 2026The remaining case from 1.8.2: a collapsed sidebar icon still showed the seam, because it inherited the alpha from its parent rather than declaring it itself.

1.8.27 Sept 2026Sidebar navigation icons showed a darker seam where their strokes cross — an alpha-in-color bug the contrast gate had passed, because summing ratios cannot see a compositing fault.

1.8.16 Sept 2026A single class missing from AvatarGroup left a white crescent under every avatar — invisible at rest, exposed on hover.

1.8.05 Sept 2026Four optional additions, all defaulting to undefined, closing one gap: an app running the display-axis controls had no way to learn the user had just changed one, so it could not record an account-level default anywhere else.

1.7.12 Sept 2026Two appearance regressions from 1.7.0, both from the same kind of mistake: changing one property after reasoning about only one of its two effects.

1.7.02 Sept 2026Tailwind v4 dropped cursor: pointer from its preflight, so every <button> in every app on this package had fallen back to cursor: default — the package now declares the rule itself, at the base layer.

1.6.02 Sept 2026The lint:a11y gate measured the high-contrast palette twice and labelled one of the two passes as the default, so the palette every app actually runs had never been measured at all.

1.5.02 Sept 2026Three fixes in @comitor/ui/chart: a legend whose labels were painted with a background token, stacked bars rounded at every joint, and a field missing from a type in a way that pushed an app back out of the package.

1.4.02 Sept 2026FormSection's accent now tints the icon tile as well as the 4px rule on the left, so a section header carries one signal instead of two that contradict each other.

1.3.431 Aug 2026Picking a file of the wrong type stops printing a red error in the console — a fix worth its own release because a warning channel that cries every time is a channel people stop reading.

1.3.331 Aug 2026The focus ring on an Input inside a DialogBody is no longer clipped on both sides — a regression introduced by 1.3.2's own fix.

1.3.231 Aug 2026A long form in a dialog no longer has its head and its foot cut off with no way to scroll to either.

1.3.131 Aug 2026FormField stops breaking every dialog it is placed in — and changes nothing at all on the path it was designed for.

1.3.031 Aug 2026ImageUploadField — the compact row an avatar or a logo actually needs — plus the headless hook both uploaders now share.

1.2.031 Aug 2026A new entry point, @comitor/ui/uploader, with two optional peers — an app that never imports it pays nothing.

1.1.031 Aug 2026Three optional props, all defaulting to undefined: an app that passes nothing emits HTML identical to 1.0.0.

1.0.031 Aug 2026BreakingThe API is frozen — from here a breaking change means a MAJOR bump, not a minor one — and six additive items open up the last hard-coded Vietnamese strings, together with the one prop-shape change that had to land before the freeze.

0.9.129 Aug 2026A layout fix in AppLauncherPanel: app names in the grid variant overflowed their cell instead of truncating, because the truncate class there never had anything to bite on.

0.9.029 Aug 2026BreakingThree components had Vietnamese hard-coded where props could not reach it; this release opens them up, and changes one default in a breaking way.

0.8.029 Aug 2026Progress gets the tone="warning" that 0.7.0 measured and refused, solved with a non-colour signal; the three existing tones are untouched.

0.7.029 Aug 2026Three gaps that consuming apps were patching in their own code become real API: a fixed reference time for RelativeTime, a warning Alert, and tones for Progress.

0.6.226 Aug 2026ComitorLockup's size table is rebuilt as a proportional scale, so at sm, md and lg the slogan no longer runs wider than the wordmark and stretches the gold rule past it.

0.6.126 Aug 2026Five presentation fixes — three of them one tailwind-merge trap that silently dropped leading-* — plus variant="auto" on ComitorLogo.

0.6.026 Aug 2026BreakingTwo new display axes — font size and layout density — plus a tablet sidebar default; --radius changes units and DataTable's density changes how it works.

0.5.126 Aug 2026DataTable's isRowActive is usable: it marks each cell with an inset shadow instead of tinting the row background.

0.5.026 Aug 2026BreakingAn audit pass over real apps: new tokens for choice borders and table rows, six changes to read before upgrading, and a run of geometry and transparency fixes.

0.4.024 Aug 2026Adds RouteTabs for tab bars whose items are real routes and a striped prop on DataTable, and restyles StatCard back to its approved design.

0.3.324 Aug 2026Two layout bugs found by real use of the package: a large blank strip below long pages, and a sidebar that highlighted every nav item sharing a pathname.

0.3.224 Aug 2026Submenus in DropdownMenu, ContextMenu and Menubar never became visible; SubContent is now wrapped in a Portal in all three.

0.3.124 Aug 2026Two shell details realigned with the Patterns section of comitor-ds: the active sidebar row drops its left rule, and the header search box moves to the center.

0.3.024 Aug 2026BreakingThe default palette reverts to the approved comitor-ds colors, and the WCAG-corrected palette that shipped through 0.2.2 becomes an opt-in [data-contrast="high"] mode.

0.2.224 Aug 2026Three bugs no amount of code review could catch — they only appear once the package is rendered in a real browser or loaded by real Node.

0.2.124 Aug 2026Four fixes, all surfaced by the first real app built on the package, plus searchParams support in the shell's active-nav matching.

0.2.024 Aug 2026BreakingAn API cleanup plus a package-wide contrast pass: renames and removals land before any app consumes the package, and colour gains a three-role token contract so text and controls reach WCAG AA in both themes.

0.1.023 Aug 2026First release on npm.