Changelog | AniUI

v0.7.12026-09-15

Time Picker and docs corrections#

featNew TimePicker (custom scroll-wheel columns), DateAndTimePicker (AniUI Calendar + time wheels), and DateTimePicker alias — full date/time coverage with zero extra npm deps, alongside the calendar-based DatePicker.
docsDedicated Date & Time Picker docs page at /docs/date-and-time-picker with usage, props, constraints, and live preview.
docsComponent count updated to 149 across homepage, README, llms.txt, MCP docs, and example apps; Date & Time Picker added to starter demos.
docsDatePicker docs no longer incorrectly claim @react-native-community/datetimepicker; all pickers are now custom AniUI source.
fixCorrected stale @react-native-community/datetimepicker references in Claude command templates and removed the unnecessary dependency from example apps.

v0.7.02026-09-08

Production-readiness pass: new native dependencies, CLI install fixes#

featTwo new carousels: vertical-flow-carousel (tap-to-focus vertical stack with tilt/scale/blur on neighbors) and vertical-page-carousel (full-bleed vertical paging deck with scale/opacity ramp and haptic tick on release) — 148 components total.
featmorph-fab, gooey-popover, and gooey-search-tabs land as a new gooey/morph family, sharing a Blur+ColorMatrix metaball technique for merging shapes without a shader.
breakingRemoved 7 components that never grew past a rough first draft: disclosure-group (a near-duplicate of Accordion), border-beam, gooey-switch, morph-loader, verified-shine, radiant-button, and squircle-view. None of these ever shipped in a published @aniui/cli release (npm's most recent published version before this one was 0.5.0), so there is no live-user migration path affected — anyone who already ran aniui add on one of these has their own local copy untouched; the CLI simply stops offering the name going forward.
fixMultiple carousel and gesture-driven components had positioning bugs traced to using full-window/full-device measurements (useWindowDimensions, safe-area insets) instead of the component's own actual rendered size: carousel-circular's card corners rendered as a plain rectangle instead of a rounded, shadowed card; curved-bottom-tabs accumulated up to 10px of drift and could clip its notch curve at the first/last tab; mobile-dock mis-mapped touches once the icon row had any padding, highlighting the wrong icon; animated-header-scrollview reserved unnecessary top space when embedded mid-page. All four now measure their own onLayout size (with a device-value fallback before first layout) instead of assuming they own the full screen.
fixTray could work once and then fail to reopen: its content view fully unmounted the Modal on every close, and re-opening before the native Modal window finished tearing down could silently fail — a known class of Android timing bug. The Modal element now stays permanently mounted with its own visible prop toggling native show/hide, and the entrance animation is retriggered by a helper decoupled from onLayout instead of relying on a remount.
fixUnfold Menu's expand animation could overshoot its target bounds (a spring's natural overshoot was never clamped) and its trigger icon could detach and drift toward the screen edge mid-morph instead of fading in place; both fixed with Extrapolation.CLAMP on the driving interpolations and a compensating counter-transform on the icon.
fixStacked Chips rendered its revealed levels with no visible gap against the trigger; Event Ticket's barcode was invisible (bars sized 4-22px inside a 32px-wide box) and its rotated code text could overlap the barcode above it; Receipt Card was missing its drop shadow entirely. All three fixed.
docsSidebar navigation reorganized by component purpose instead of historical placement: a new dedicated Buttons section (Button, FAB, Social Button, Flexi Button, Save Button, Spin Button), a new Carousels section promoted to top-level, a new consolidated Loaders section, and Overlays/Navigation/Pieces regrouped with sub-headers where a category had grown large (Forms & Inputs, Overlays & Menus). Verified programmatically against the full registry — zero components dropped or duplicated in the move.
docsSynced ~60 component doc previews with their mobile example-app demos, which had drifted apart over time (different sample data, different item counts, in a few cases an outdated illustration of the component's own behavior — carousel-circular's preview in particular still showed the old, since-replaced circular layout).
fixCLI: aniui add, add-block, and doctor now route every dependency install suggestion for a component through expo install on Expo projects, matching the approach aniui init already used — a plain npm/yarn/pnpm/bun install pulls whatever a package's "latest" tag happens to be, which can be ahead of what the project's Expo SDK actually supports, while expo install resolves the SDK-compatible version. This matters most for the newer Tier 4/gooey components' native dependencies (@shopify/react-native-skia, expo-blur, expo-haptics, react-native-qrcode-svg) but applies to every native/linking dependency the CLI suggests installing.
featcli/src/deps-versions.ts now also tracks @shopify/react-native-skia, expo-blur, expo-haptics, and react-native-qrcode-svg per Expo SDK bucket, alongside the existing Reanimated/gesture-handler/safe-area-context pins.
fixexamples/bare_rn_starter's tsconfig.json was missing a paths mapping for the @/* import alias entirely (every other example app has one) — harmless at runtime since Metro's own module-resolver alias was configured correctly, but it meant tsc --noEmit reported a "Cannot find module" error on almost every one of that app's 148 component imports. Added the missing paths entry.
featSingle source of truth for colors: components/ui/theme-provider.tsx now exports useThemeColors(), a hook returning the current light/dark hex palette for anything that can't read a className token — TextInput caret/placeholder, Switch track/thumb, Slider fill, icon color, chart canvas fills, and more. Migrated 48 components off their own independently-hardcoded hex approximations (several of which had already drifted, e.g. #18181b vs #09090b for the same "dark foreground" role) onto this one hook. aniui init and aniui theme keep it in sync with whichever preset a project has chosen — picking a new preset updates both global.css and theme-provider.tsx's hex table together, and aniui add patches it in for any of these components added later. Fixed 8+ confirmed dark-mode bugs as a side effect (icons in search-bar, password-input, combobox, select, header, and others that never adapted to dark mode at all). Also unified cli/src/commands/theme.ts and init.ts's two separately hand-maintained preset objects into one cli/src/theme-presets.ts.
fixGooey Popover: the panel was invisible in light mode (its Skia backdrop defaulted to the same white as the page background, with no border of its own for definition) and could misalign once its content wrapped to two lines (no screen-edge clamping, so a wide panel centered under a narrow trigger could overhang past the edge). Also fixed the trigger button rendering fully hidden behind its own backdrop canvas — both had an effective zIndex of 0, and the canvas being a later sibling won that tie.

v0.6.12026-09-05

Realistic example demos + overlay positioning fixes#

featRewrote all 102 example-app demos from generic variant showcases into realistic use cases a real app would ship — settings screens, checkout flows, a full ChatGPT/Claude-style chat composer, dashboards, a swipe-to-archive inbox, and more — with genuinely wired-up state instead of static prop galleries. Full variant/size/state coverage was kept as additional sections on the most-used primitives (Button, Input, Textarea) so nothing already documented got lost. Also recategorized every example app's home-screen catalog to match the docs sidebar's 8-category taxonomy instead of one flat alphabetical list.
fixSelect's dropdown opened ~30px below its trigger on New Architecture: measureInWindow() already returns window-absolute coordinates, and the component was adding insets.top back on top of that, double-counting it. Removed the extra offset.
fixPopover, HoverCard, DropdownMenu, and Tooltip content also opened with unwanted extra space before this fix, for a different reason: their Trigger wrapped children in a Pressable forced to a 48x48 box via min-h-12/min-w-12, and @rn-primitives measures that exact box to position content — so a small icon child always opened content ~48px below the trigger's top edge instead of just past the icon. Removed the forced sizing and added hitSlop={14} to keep the 48dp accessible tap target without inflating what gets measured. Also wired real useSafeAreaInsets() into all four Contents, which had none before.
fixTooltip needed one more fix beyond the above: its default side="top" positioning clamps against insets.top, and its Trigger measures via the plain measure() API (not measureInWindow()) — the same status-bar-offset inaccuracy documented elsewhere in this codebase — which kept pinning the tooltip near the top inset instead of near the trigger. Zeroes out just insets.top for Tooltip specifically; Popover/HoverCard/DropdownMenu's side="bottom" default doesn't hit this.
fixThe example apps' shared component-preview screen sized its outer ScrollView and SafeAreaView with flex-1 via className, which didn't reliably reach either component under this styling setup — both collapsed to zero height, hiding every demo's content while the native header still rendered fine. Switched both to a plain style prop, matching the pattern already used on the catalog screen.
fixAll 7 example apps now default to the light theme on launch regardless of the device's system setting.
docsBumped stale "101"/"89" component-count references to 102 across the root and CLI READMEs, the MCP docs page, the homepage, and the bare-RN-starter screens. Homepage hero also gets a small stat strip (Components / Screen Blocks / Expo SDKs / License).
fixDocs site always painted light first and only switched to dark after a client-side effect ran — a visible flash for visitors whose system prefers dark. A blocking inline script now applies the stored or system-preferred theme before the page paints.

v0.6.02026-09-05

AutoComplete, 48dp touch-target sweep + docs overhaul#

featNew AutoComplete component (102 total): a free-text input with an inline filtered suggestion dropdown — distinct from Combobox (modal select-from-a-fixed-list) and SearchBar (no suggestions at all). Supports a custom filterFn, minCharsToTrigger, an async loading state, disabled options, and a clear button. The dropdown renders as a normal View below the input rather than position: "absolute" (no reliable viewport-relative overlay without a portal, and it's Tier 1). Grouped with Input and SearchBar via cross-links on all three doc pages.
fix48dp touch-target sweep across 9 components that fell under the CLAUDE.md-mandated min-h-12/min-w-12 minimum: PromptInput's toolbar/send buttons, Stepper, Select's search field, DropdownMenu/ContextMenu item rows, Calendar's day/month/year/nav cells, and Menubar — plus PasswordInput's and SearchBar's compact icon buttons, which keep their visual size and gain hitSlop instead. A new aniui lint:components script catches this class of regression going forward.
fixPromptInputTextarea was missing textAlignVertical="top" (Android-only cursor-centering bug once the box hits maxHeight and scrolls), and the Prompt Input docs' hero preview had a + button and a model-selector button with no onClick handler at all — both now open real, working dropdowns matching the docs' own description.
featNew cli/src/deps-versions.ts: a per-Expo-SDK-bucket manifest for native/animation dependency versions, closing the gap where the registry only centralized dependency names, never versions. The compatibility page's Reanimated version-matrix row now reads from it instead of a hand-typed cell. Safe version bumps applied (react-native-svg, @gorhom/bottom-sheet) — never past what a given Expo SDK actually bundles.
featExpo SDK 57 gets its own named detection seam (ProjectInfo.sdk56Plus/sdk57Plus) instead of inline expoMajor >= 56 checks scattered across init and doctor — behavior is unchanged today, but a future SDK 58 divergence now has somewhere to attach.
fixdate-picker, carousel, toggle, and toggle-group were mislabeled Tier 2/3 in CLAUDE.md's human-readable table (needing reanimated or an external datetimepicker dependency) when the registry — and the actual component source — has always had them as Tier 1. Also removed a dead datetimepicker dependency check in the add command that could never fire.
fixThree example apps (expo-55, expo-56, expo-56-nw4-starter) shared one dangling real EAS project/owner/updates block across three otherwise-distinct app slugs — a copy-paste artifact and a public-repo privacy leak, and a plausible trigger for a reported Expo Snack "Failed to upload file asset" import error. Sanitized all three; expo-starter's own EAS project (the real, intentionally-published one behind the site-wide QR code) is untouched.
featWired the docs site's existing (but previously unused) Expo Snack iframe into the component preview's "native" tab, and added scripts/sync-examples.js so the 8 example apps' component mirrors no longer have to be kept in sync by hand.
docsEvery component doc page's "Source" section now reads live from the real component file (via the same registry JSON build-registry.js already generates) instead of a hand-copied string nobody re-synced — the exact gap that let the Prompt Input docs describe a touch target the code had already moved past. Covers all 90 .tsx pages plus 5 MDX pages via a new <Source slug="..." /> component.
docsSidebar navigation restructured from one flat 94-item "Components" list into 8 collapsible, function-based categories (Foundation, Forms & Inputs, Feedback & Status, Overlays & Menus, Navigation & Structure, Data Display & Media, Chat & AI, Gestures & Actions), with state persisted per-visitor. New /docs/components category index fixes a previously orphaned route. dialog and select now get the same web/native preview toggle every other component page has.
docsUnified the docs site's two parallel code-highlighting systems onto Shiki (dual light/dark theme) across all 29 pages that still used a single-theme client-side highlighter — every blocks/* page, every charts/* page, and 7 getting-started guides. Dropped the now-unused sugar-high dependency.
fixReduced-motion support added to Skeleton's pulse, TypingIndicator's bounce, Waveform's ambient bars, and StreamingText's blinking cursor — none had any awareness of the setting before. Slider's fill track now animates transform: scaleX instead of width, avoiding a native layout pass on every drag frame.
docsDocs site micro-interaction polish: the copy button on every code sample gets a real Copy/Check icon crossfade instead of a text-only swap, the sidebar scrolls its active item into view on navigation and fully respects reduced motion, and the two "active pill" spring configs that had quietly drifted apart are now one shared constant.
featCLI bumped to 0.6.0.

v0.5.02026-07-15

Lucide icons, AI components + 101 components#

v0.4.02026-07-05

Expo SDK 57 + Uniwind is now the default#

v0.3.02026-05-23

Expo SDK 56 Support#

v0.2.292026-05-08

TextInput Refs#

featInput, Textarea, PasswordInput, SearchBar, MaskedInput, PhoneInput, NumberInput: forward ref to the underlying React Native TextInput. Lets callers do inputRef.current?.focus() / blur() / clear() imperatively — useful for autofocus after a validation error, chaining inputs on submit, or programmatic dismissal.

v0.2.282026-05-08

Toast Positions & Animate Auto-Install#

v0.2.272026-05-08

Windows Path Fix#

fixCLI: import paths in installed components were using OS-native separators on Windows (e.g. import { cn } from "..\..\lib\utils"), which TypeScript parses as unicode escape sequences and rejects with 'Bad character escape sequence'. Normalized path.relative() output to forward slashes in both add and add-block commands.

v0.2.262026-05-08

SegmentedControl Dark-Mode Contrast#

fixSegmentedControl: bumped the dark-mode active segment background from #27272a to #37373a so it visibly elevates above the muted track instead of blending in.

v0.2.252026-05-07

NativeWind v5 Crash Fix & Calmer Animations#

v0.2.242026-05-07

iOS Dark Mode Sweep & Generic SegmentedControl#

fixSwitch: thumb is no longer invisible on iOS in dark mode. iOS thumbColor was previously gated to Android-only, leaving a white thumb on a near-white ON track. Thumb now derives from value across both platforms.
breakingSwitch: renamed thumbColorAndroid prop to thumbColor (now applies to both platforms).
fixBottomSheet: sheet body and handle indicator now adapt to dark mode (was hardcoded #ffffff, making content unreadable on iOS dark).
fixActionSheet: same dark-mode background fix as BottomSheet.
fixSegmentedControl: active segment background and label colors now adapt to dark mode (active was hardcoded #ffffff and disappeared into bg-muted).
fixInfiniteList: footer ActivityIndicator color now flips with the color scheme (was hardcoded dark, invisible on dark backgrounds).
fixSpinner: default color now adapts to dark mode when the color prop is not supplied.
fixTextInput components (Input, Textarea, PasswordInput, SearchBar, InputOTP, MaskedInput, PhoneInput, NumberInput, Combobox, Select): added keyboardAppearance, selectionColor, and cursorColor so the iOS keyboard matches the theme and the caret stays visible against dark input backgrounds.
featSegmentedControl: now generic over T extends string | number — binds cleanly to enums and string unions. options accepts T[] (with optional parallel labels?: string[]) or { value, label?, disabled? }[] for unambiguous i18n pairing.
fixSegmentedControl: long i18n labels are now truncated to one line so layout stays stable across locales. onValueChange no longer fires when re-tapping the already-selected segment. className prop now merges with internal classes via cn() instead of being silently dropped.

v0.2.222026-04-20

v0.2.212026-04-19

CLI Bug Fix, SEO Overhaul & Premium Homepage#

fixCLI: fixed Cannot find module package.json crash when running via npx (compiled path resolution bug)
fixCLI: extracted shared getCliPackage() utility to resolve package.json from both source and dist paths
fixSEO: OpenGraph URL fixed from relative './' to absolute 'https://aniui.dev'
featSEO: OG image and Twitter image configured for rich social sharing previews
featSitemap: added 22 missing pages (15 blocks + 7 charts) for full search engine coverage
docs82 unique SEO descriptions for component pages — 'AniUI Button — pressable with 5 variants...' format
docsllms.txt: added Charts (7), Blocks (15), and Why AniUI sections for LLM discoverability
featHomepage: premium hero with dot pattern background, larger typography, GitHub star button, and 89+ badge
fixProps table: added break-words to Default column to prevent overflow on narrow screens

v0.2.202026-04-19

Tabs Rewrite, SEO Metadata, Anchor Links & Bug Fixes#

featTabs: rewritten with filled/line variants, sm/md/lg sizes, vertical orientation, disabled, icons, and RTL support
featSEO: added layout.tsx with title and description metadata to all 82 missing doc pages
featAnchor links: all 673 headings across 93 doc pages now have auto-generated IDs and clickable # links
featHeading component: reusable component with slugify, scroll-mt-20 offset, and hover # indicator
featHash navigation: URLs like /docs/chip#closable now smooth-scroll to the section
featShared constants.ts: single source of truth for component count and site metadata
fixTabs: added will-change-variable to prevent NativeWind v5 state reset warning
fixRefreshControl: theme-aware tintColor via useColorScheme, overridable via props
fixStale counts fixed: MCP page (48), docs intro (81), preview-toggle (81), CLI README (81) all updated to 89
fixCard layout.tsx: title corrected from lowercase to capitalized
docsTabs docs: 7 interactive preview sections (filled, line, vertical, disabled, icons, sizes, RTL)
docsTabs examples: full 7-section demos in all 4 example apps using actual Tabs component
docsDocs root layout description updated to 89 components

v0.2.192026-04-17

featAnimate: spring presets, layout animations, easing curves, usePressAnimation hook for Reanimated 4
featData Table: sortable columns, search filtering, pagination, custom cell rendering, striped rows
featCommand Menu: Spotlight-style searchable palette with groups, keyboard shortcuts, disabled items
featCLI: aniui status, aniui diff, aniui update commands with component manifest tracking
featCLI: add command now writes version + hash to .aniui.json for smart update detection
fixData Table: replaced FlatList inside ScrollView with plain View rows, fixed column alignment with minWidth
fixTests: added 9 test suites (32 tests) for all new components; excluded animate from component pattern tests
fixMCP registry synced from 57 to 89 entries to match CLI registry
docsNew doc pages with interactive previews for Animate, Data Table, and Command Menu
docsData Table docs: live previews for sorting, search, pagination, custom cell, and striped sections
docsComponent count updated to 89 across docs, README, llms.txt, .cursorrules, and all examples
docsFull demos (6 sections each) for Data Table and Command Menu in all 4 example apps

v0.2.182026-04-15

New Components, RTL Support & Input Group Rewrite#

featField component: layout-focused form field with label, description, and error slots
featInput Group component: rewritten with focus-aware container, CVA button variants, and textarea support
featKbd component: keyboard key display with size variants and KbdGroup separator
featHover Card component: preview content triggered by long-press, built on @rn-primitives/hover-card
featDirection Provider component: RTL/LTR context with I18nManager integration and useDirection hook
featCombobox: multi-select with chips, groups, clear button, custom rendering, invalid/disabled/auto-highlight/popup mode
featRTL guide with interactive language selector, logical properties table, and component support matrix
fixRTL: migrated 16 components from physical (ml-/mr-/border-l/right-) to logical (ms-/me-/border-s/end-) properties
fixAdded @rn-primitives/hover-card to all example package.json files
docsNew doc pages for Field, Input Group, Kbd, Hover Card, Direction Provider, and RTL guide
docsComponent count updated to 89 across all docs, README, llms.txt, and examples
docsFull demos for all 5 new components added to all 4 example apps

v0.2.172026-04-13

Syntax Highlighting + Bug Fixes#

featDocs: syntax highlighting for all code blocks via shiki (server-side, zero client JS)
featDocs: MDX infrastructure — pages can now be authored in MDX with auto-highlighted fenced code blocks
featDocs: all 78 doc pages converted to server components for faster loads
fixSwitch: hardcoded light-only colors replaced with dark mode support via useColorScheme()
fixSwitch: added trackColorOff, trackColorOn, thumbColorAndroid props for custom theming
fixog:url meta tag now reflects the current page URL instead of always pointing to the homepage
docsllms.txt updated from 48 to 82 components to match full registry

v0.2.142026-04-06

Uniwind Support + Universal Theming#

featFull Uniwind styling engine support — same components work with NativeWind and Uniwind
featUniwind dark mode via @layer theme + @variant light/dark in global.css
featCLI init generates correct Uniwind config: metro.config.js, global.css, @import "uniwind"
featCLI doctor validates Uniwind-specific setup (withUniwindConfig, @variant dark, @import)
featTheme presets (default, blue, green, orange, rose) now apply to both light and dark variants
featwithUniwind() HOC for third-party components like SafeAreaView
featreact-native-svg added as core dependency for inline SVG icons in components
featwith-uniwind example app with 77 interactive component demos and theme toggling
fixfile-picker.tsx: replaced inline <svg> (crashes on RN) with react-native-svg
fixcalendar.tsx, password-input.tsx, select.tsx: compacted SVG icons to meet 120-line limit
fixBare <Text> tags in example app now have text-foreground class for proper theming
fixreact-native-svg pinned to 15.15.3 across all example apps
fixpackage-lock.json synced to fix npm ci failures in CI
docsDark mode guide updated with Uniwind section (@variant light/dark + Uniwind.setTheme())
docsInstallation guide updated with react-native-svg in all install commands

v0.2.132026-03-26

Expo 55 + NativeWind v5 Support#

featDual SDK support: Expo 53/54 (NativeWind v4) + Expo 55 (NativeWind v5)
featCLI auto-detects SDK version during aniui init
featVersioned templates (v4/ and v5/) for each SDK generation
featexpo-55-starter example app with NativeWind v5 + Tailwind v4
featReact Native Testing Library render tests for all 54 components
docsCompatibility guide with version matrix and migration steps
docsChangelog page

v0.2.122026-03-25

Charts + Input Enhancement#

feat7 chart components: Area, Bar, Line, Pie, Radar, Radial, Tooltip
featCharts landing page with live previews and horizontal tabs
featInput: leadingIcon and trailingIcon props
featExpanded static test suite (824 tests)
featMCP integration and documentation

v0.2.112026-03-20

Bare React Native Support#

featBare React Native CLI support in aniui init
featMetro + Babel templates for bare RN projects
featbare-rn-starter example app

v0.2.102026-03-19

Full Component Library#

feat18 new components (47 total)
featRedesigned homepage with live theme preview
featCreate page with theme editor
featBlocks: 15 pre-built screen templates
featShared nav data and theme data system

v0.2.92026-03-16

Initial Release#

feat29 components across 3 tiers
featCLI with init, add, theme, mcp, and generate commands
featTheme system with 5 presets and dark mode
featMCP server for AI tool integration
featDocumentation site at aniui.dev