Changelog
All notable changes to VhyxUI are documented here. This project follows Semantic Versioning.
v0.1.0-alpha.1
First public alpha release of VhyxUI. All 22 Tier 1 components are implemented, tested, and documented. The token system, accessibility layer, motion system, and VhyxSeal agent contracts all ship together.
What's included
- @vhyxui/tokens — Full CSS custom property system. Primitives, semantic layer, dark mode, reset, and motion keyframes. Zero JavaScript. No build step.
- @vhyxui/core — Shared TypeScript types, VhyxSeal default contracts for all 22 components, Slot implementation for the asChild pattern, and VhyxUIError error class.
- @vhyxui/react — All 22 Tier 1 components with full prop APIs, accessibility (WCAG 2.1 AA), motion, and VhyxSeal contracts. Dual CJS / ESM build. Tree-shakeable per-component imports.
- VhyxUIProvider — Root provider with skip-link, Toast region, and theme context.
- toast() imperative API — Call
toast(),toast.success(),toast.danger()from anywhere without props or context wiring. - Form + Field architecture — First-class Field component auto-wires label, hint, and error to the child input. Native react-hook-form + Zod integration.
- Agent contracts — Every component ships with a default VhyxSeal contract readable via
data-vhyx-contract. Destructive Button variant auto-upgrades tosafetyLevel: critical. - Dark mode — Full semantic token set for
[data-theme="dark"]. No extra CSS to write. - prefers-reduced-motion — All duration tokens collapse to 0ms automatically. Zero JavaScript required.
All 22 components
Inputs & Forms
- Button
- Input
- Textarea
- Select
- Checkbox
- Radio
- Switch
- Form & Field
Feedback
- Toast
- Alert
- Badge
- Progress
- Spinner
Overlay
- Dialog
- Drawer
- Tooltip
- Popover
Layout
- Card
- Separator
Navigation
- Tabs
- Breadcrumb
- Pagination
Known limitations
- No React Native support — web only in alpha.
- Form component requires react-hook-form; standalone usage with native form state is not yet documented.
- VhyxSeal contracts ship as data attributes but the full manifest generation CLI is not yet published.
- SSR-safe animation is handled via CSS only; JavaScript-driven exit animations on unmount are not supported.
- No Storybook integration yet — the Playground (play.vhyxui.com) serves as the interactive reference.
- Dark mode requires data-theme="dark" on a parent element — automatic system-preference detection requires opt-in via ThemeProvider.
- Accordion and Combobox are Tier 2 components and are not yet included.
Alpha notice. This is a pre-release. APIs are stable but not semver-frozen until v0.1.0. Minor breaking changes may occur between alpha versions. Pin your version and check this changelog before upgrading.