# Changelog (/ui/changelog/react)

> Every `@appica/ui-react` release, newest first, split by what it touched: the library, its documentation, and the Figma community file. The icon and country flag packages ship on their own schedules and keep their own changelogs.

## 1.1.0 - August 11, 2026

8 new components including a full color system, a prebuilt stylesheet for projects without Tailwind, and an API reference generated from the library types.

### [ui] @appica/ui-react

**Added**

- **[Card](/ui/components/react/card)** - A server-safe layout container with `CardMedia`, `CardHeader`, `CardTitle`, `CardDescription` and `CardFooter` slots, an optional solid or glass frame, and an inset mode that floats media into a fully rounded panel. Every corner derives from a single `--card-radius`, so retuning one value keeps the nest concentric.
- **[Color Picker](/ui/components/react/color-picker)** - A swatch trigger and a popover holding an HSB area, a hue slider and a text input. It shares one color with every color component below it through context, so an area, a slider and a palette need no value wiring. `ColorPickerInput` reads any string `parseColor` accepts, not only the format it prints, and `ColorPickerEyeDropper` samples a screen pixel where the browser has an EyeDropper (rendering nothing where it does not).
- **[Color Area, Color Slider, Color Swatch and Color Swatch Picker](/ui/components/react/color-area)** - The 4 building blocks behind the picker, each usable on its own: a two-axis HSB plane, a channel slider, a single swatch, and a selectable palette.
- **Color model** - `parseColor`, `formatColor`, `convertColor` and the channel helpers ship from `@appica/ui-react/color`. An alpha format collapses to its opaque twin at full opacity, so a solid color is written `#3b82f6` rather than `#3b82f6ff`.
- **[Rating](/ui/components/react/rating)** - A `radiogroup` of icon buttons that sweeps a fill preview across the row under the pointer and commits on click. The preview always lands on a `step` boundary, so it never promises a value the click will not deliver. Swap the built-in star through `icon={{ empty, filled }}`, and recolor the whole control with any `text-*` utility.
- **[Border Beam](/ui/components/react/border-beam)** - A comet of light that laps your content's border, painted as a conic sweep clipped to a hairline ring so it follows the wrapper's own `border-radius` exactly, from a `rounded-xl` card to a full pill, with no radius prop to keep in sync. Pure CSS, mirrored in RTL and reduced-motion aware.
- **[Carousel thumbnails](/ui/components/react/carousel)** - `CarouselThumbs` is a rail of `CarouselThumb`s that sits inside the carousel and drives it, with no second engine to wire up by hand. The rail is a carousel of its own, so a set with more shots than fit scrolls instead of squeezing, and selection is drawn as a single outline that slides between thumbnails.
- **[frame prop on Dialog, AlertDialog and Drawer](/ui/components/react/dialog)** - Wraps the popup in a translucent glass frame over the backdrop. Pass `frame={false}` for a plain solid card.
- **[Prebuilt stylesheet](/ui/docs/react/installation)** - `@import '@appica/ui-react/css'` pulls in a single self-contained `appica.css` carrying every component's styles and the full token system, for projects that do not run Tailwind. It is linkable straight from a CDN, and tokens stay overridable CSS variables so theming works the same way.
- **[Agent rules in the package](/ui/docs/react/agents)** - `@appica/ui-react/agent-rules.md` ships the rules a coding agent needs to use the library correctly, so an agent that wandered in following an import finds them without the docs site. The README links it.

**Improved**

- **Prop documentation comes from the source** - All 366 props declared on our own types now carry JSDoc, so a component's comments, its IDE hover and the published API reference cannot drift apart. `Badge`, `Button`, `Alert` and `TabsList` declare `variant` and `size` explicitly, so hovering one shows the union and its default instead of an empty interface body.
- **[Text Animate shimmer](/ui/components/react/text-animate)** - Reworked as a seamless gradient glare that sweeps the whole string as one band, rather than brightening character by character.
- **Dependencies** - Base UI 1.7, Motion 13, Tailwind CSS 4.3 and TypeScript 6 across the workspace, and the development Node floor moves to 22. React 19 and Tailwind CSS 4 remain the only peer requirements.

**Fixed**

- **Menu padding** - Dropdown Menu and Context Menu keep their padding inside the scrollport, so pressing the last item no longer scrolls the list under the pointer.

### [docs] appica.dev/ui

**Added**

- **[Pages for the new components](/ui/components/react/card)** - Card, Rating, Border Beam and the 5 color components, each with a playground, worked examples, an RTL demo and an API reference. The Color Picker page covers the default panel plus custom compositions: variants, presets, opacity, the eyedropper, inline mode, custom triggers, form fields and controlled use.
- **Custom brand colors in the theme customizer** - The customizer takes a hex color and generates a full 11-stop ramp from it, so the primary and secondary axes are no longer limited to the named palettes. Everything downstream (tokens, dark mode, the CSS export) resolves through the same recipes as a built-in palette.
- **[Set up your coding agent](/ui/docs/react/agents)** - A guide carrying the rules to paste into your own `AGENTS.md`, read out of the installed package at build time so the published text always describes the version you would install.
- **[The no-Tailwind path](/ui/docs/react/installation)** - The installation guide documents the prebuilt stylesheet end to end: the import, the CDN link, what it freezes, and why you should not load it alongside Tailwind.
- **Portal escape hatches, forms and custom theming** - Every overlay page documents the `container` prop for shadow DOM and iframes, the Form page covers validation, and the theming guides cover going beyond the token defaults.

**Improved**

- **API reference tables are generated** - Prop tables are assembled from the library's shipped types plus a per-page sidecar instead of being maintained by hand. That surfaced 518 rows for Base UI props the tables never listed, including the full positioner surface on every `SubContent` part, and widened 10 `side` unions that omitted the logical sides they accept. Tables stay literal Markdown, so they survive into the page's agent-readable `.md`.
- **Agent-facing docs pipeline** - Every prose page publishes its processed Markdown at `<page>.md`, and `llms.txt` links only those (a bare page URL is ~580 KB of HTML for 8 KB of content). `llms-full.txt` is gone: at 1.3 MB it could only crowd out the context of whoever loaded it.

### [figma] Figma community file

**Added**

- **Card** - The new Card component, built as a container over Figma slots so any content can be dropped into the media, header and footer areas without detaching the instance.

## 1.0.0 - July 9, 2026

The first public release: the component library, its documentation, and the Figma file behind it.

### [ui] @appica/ui-react

**Added**

- **[60+ components](/ui/components/react/button)** - Built on Base UI primitives, animated with Motion and styled with Tailwind CSS v4 design tokens. Accessible by default, right-to-left ready, and quiet when the reader prefers reduced motion.
- **[Providers and hooks](/ui/docs/react/theme-provider)** - `ThemeProvider`, `DirectionProvider` and `ReducedMotionProvider`, plus `useTheme`, `useDirection`, `useMediaQuery`, `useLocalStorage`, `useDismissible` and `useReducedMotion`.
- **[Token-based theming](/ui/docs/react/theming)** - Every color, radius, font and shadow is a CSS variable, so a project retunes the library by redefining tokens rather than overriding component styles. Dark mode ships with no flash of the wrong theme.
- **[Composition through render](/ui/docs/react/composition)** - Every component takes a `render` prop, so it lends its behavior and styling to an element you supply - a `next/link`, a `<button>`, another component - rather than wrapping it in one more node.

### [docs] appica.dev/ui

**Added**

- **[appica.dev/ui](/ui)** - A page per component with a live playground, worked examples whose code is read from the example file itself, an RTL demo and an API reference, alongside the installation and theming guides.
- **Theme customizer** - Retune the base, primary and secondary colors, the radius and the font from the site header, preview it across every page, then export the CSS.

### [figma] Figma community file

**Added**

- **Community file** - The design source for the library, published free on the Figma community: components with variants and states, bound to the same variables the code ships.
