Appica UIUI 1.1.0

Changelog

Every @appica/ui-react release, newest first. Each entry is 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.

For AI Agents

  1. 1.1.0

    Latest

    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 - 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 - 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 - 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 - 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 - 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 - CarouselThumbs is a rail of CarouselThumbs 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 - Wraps the popup in a translucent glass frame over the backdrop. Pass frame={false} for a plain solid card.
    • Prebuilt stylesheet - @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 - @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 - 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 - 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 - 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 - 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.

  2. 1.0.0

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

    [ui]@appica/ui-react

    Added

    • 60+ components - 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 - ThemeProvider, DirectionProvider and ReducedMotionProvider, plus useTheme, useDirection, useMediaQuery, useLocalStorage, useDismissible and useReducedMotion.
    • Token-based 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 - 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 - 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.

© 2026 Appica UI. A free component library, crafted by the Appica team.