Changelog

This update follows the March release candidate with ecosystem listing, a new Hitbox utility, expanded hooks and agent documentation, site improvements, and many fixes across theming and components.

Registry & ecosystem#

• shadcn registry — Shark UI is wired into the broader shadcn registry configuration via components.json
• Registry build — Manifest and public/r/*.json metadata refreshed; registry build script updated for maintainers

New utility#

• Hitbox — Enlarge tap and click targets without changing layout; includes docs, registry examples, and dedicated styles

Hooks & CLI-facing docs#

• use-is-mobile — Documented hook for responsive behavior
• style, ui, utils — Registry items exposed for CLI installs alongside other meta updates

Site & product#

• Blocks — Early /blocks route scaffold for the blocks experience
• Analytics — Site analytics integration
• Funding — Ko-fi support link in project metadata
• Agent skill — Shark UI skill for Cursor and expanded primitive references for contributors and coding agents

Documentation & layout#

• Installation & components — Dedicated overview pages for installation and the component index (ComponentsList), with framework guides remaining under Installation
• Docs shell — Fixes for table of contents when headings are sparse, component doc routing, CLI copy snippets, and content replacement behavior
• Layout — Global scrollbar and overflow refinements on the docs body

Components & theming#

• Theme — Switcher reliability and reduced first-paint flicker; border and input CSS variables; background token alignment
• Dialog — RTL layout fix
• Table — Spacing and header text treatment
• CodeBlock / Highlight — Standardized prop for line numbers
• Badge — Improved touch behavior for coarse pointers
• Combobox — Follow-up fixes and examples after the combobox workstream
• Announcement — Updates from community PRs
• Drawer, Toast, Sidebar, Timer, Prose — Props, examples, and styling tweaks
• data-slot — Consistency fix for slot-based styling hooks

Dependencies & infrastructure#

• Dependency updates and small component refactors
• CI workflow adjustments for contributor runs

This release candidate builds on Beta 1 with new components, utilities, theme editor enhancements, and improved documentation. The component registry has been restructured with thumbs and consistent example naming.

New Components#

• Announcement — Banner-style component for promotions and notices
• Calendar — Full calendar with month/year navigation and range selection
• Color Picker — Color selection with swatches and input fields
• Date Picker — Date input with calendar popover and presets
• Drawer — Slide-out panel for mobile-first layouts
• Image Cropper — Crop images with zoom, aspect ratio, and constraints
• Prose — Typography styles for markdown and long-form content
• Signature Pad — Canvas-based signature capture
• Skip Nav — Accessibility link to skip to main content
• Timer — Countdown, interval, and Pomodoro timers

New Utilities#

• Client Only — Render components only on the client
• Format — Date, number, and relative time formatting
• Show — Conditional rendering with animation support
• Download Trigger — Programmatic file downloads
• Swap — Toggle between two states with animation
• Presence — Mount/unmount with enter/exit animations
• JSON Tree View — Expandable JSON display
• Highlight — Syntax highlighting for code blocks

Component Updates#

Registry examples and thumbs were standardized across components:

• Button — Variants, sizes, and icon support
• Card — Composition and theming
• Combobox — Multi-select and controlled state
• Dialog — Sizes and compositions
• Field — Required fields and validation
• Floating Panel — Positions and resize behavior
• Input Group — Button integration and addons
• Menu — Nested menus and keyboard navigation
• Number Input — Stepper and format options
• Pagination — Sizes and variants
• Select — Multi-select and custom items
• Textarea — Autoresize and validation
• Toast — Placement, types, and promises
• Toggle — Sizes, outline, and icon variants
• Tooltip — Positioning and keyboard support
• Tour — Step types, progress, and async steps

Theme Editor#

• Updated color variable system and theme presets
• Support for success, warning, info, and destructive states
• Prose typography styles for content blocks

Home Page#

• Redesigned hero with Announcement component
• Component examples (Input OTP, forms, calendar, charts, and more)
• Framework support badges (React, Solid, Vue, Svelte)
• Theme cards for activity, chat, and sharing examples

Documentation#

• Forms — New forms section with React Hook Form and TanStack Form guides
• RTL — Right-to-left layout support
• Component docs updated with API references and examples
• New installation guides for various frameworks

Infrastructure#

• Open Graph image generation for docs and changelog
• RSS feed and sitemap generation
• LLMs.txt route for AI crawlers

Dependencies#

• Package updates for Next.js, React, Ark UI, and dev tooling

Beta 1 marks the first public release of Shark UI. The goal was to build a set of components on Ark UI styled with Tailwind CSS, so you can add accessible primitives to a project without wiring up styles from scratch.

Components#

Roughly 80+ components are available, grouped into several categories:

• UI primitives: Accordion, Alert, Avatar, Badge, Button, Card, Separator, Skeleton, Tabs
• Overlays and dialogs: Dialog, Menu, Popover, Sheet, Tooltip, Hover Card, Context Menu
• Forms and inputs: Input, Textarea, Checkbox, Radio Group, Select, Native Select, Field, Combobox, Input OTP, File Upload, Editable
• Layout and navigation: Sidebar, Scroll Area, Resizable, Pagination, Breadcrumb, Bottom Navigation
• Feedback and display: Progress, Slider, Rating Group, Toggle, Toggle Group, Steps, Carousel

Components are copy-paste: they land in your project, and you own the code. Tailwind and Ark UI are the only runtime dependencies.

Theme editor#

The theme editor lets you tweak colors and copy the resulting CSS variables into your project. Themes follow the shadcn color convention, with extra variables for success, warning, info, and destructive states.

Limitations#

This is a beta. Some components may change before a stable release. If you run into issues, open an issue on GitHub.