Docs
Components
Every component below is open code you add to your own project. Each component page gives you a live preview, the CLI install command, the full source, basic usage, props, examples, and required dependencies where they apply.
pnpm dlx shadcn@latest add @davinciui/[component]Choosing a component#
- Start from the tâche: animated headline → Text Animations; page backdrop → Hero Backgrounds; form, feedback, or overlay UI → the matching base component.
- Open the component page and try the interactive preview first — most animated components expose their key props as live controls.
- Check the install dependencies before adding: animation-heavy pieces need
framer-motion, canvas pieces need a WebGL-capable browser. - If you customize theme tokens, skim Colors and Motion — components inherit both.
Text Animations
13Text Video Mask
Large typography where playing video shows only inside the glyphs — one continuous footage surface revealed through the type.
text-video-mask
Curved Inline Type
A sticky scroll stage where headline lines ride an invisible vertical drum, rising, flattening, and fading over the top with images and looping videos inline between words.
curved-inline-type
Shake Text
A premium 3D layered text effect with four colored depth copies that move continuously behind a stable foreground.
shake-text
Rolling Text
Mechanical slot-machine typography — every character is an independent clipped column rolling a vertical stack of its own glyphs into place.
rolling-text
Media Text Hover
A split branding headline that opens an image or video window with a responsive spring hover interaction.
media-text-hover
Random Text Reveal
Per-character text reveal in shuffled order on scroll — faint glyphs resolve randomly into solid type.
random-text-reveal
Text Morph
Centered fluid text transitions that inherit the surrounding typography and theme.
text-morph
Shader Text
WebGL fragment shaders clipped inside text glyphs via a dynamic SVG mask — twelve animated presets with fluid gradient and noise typography.
shader-text
Fluid Particle Text
Interactive particle typography sampled from rasterized text — solid at rest, liquid around your cursor.
fluid-particle-text
Encrypted Text
A continuously scrambling cipher that decrypts from left to right into a readable message.
encrypted-text
Glitch Liquid Text
GPU-rendered interactive typography on a liquid membrane — cursor-driven fluid distortion with chromatic glitch edges, light rays, and a magnetic custom cursor.
glitch-liquid-text
Text Reveal
Scroll-scrubbed text reveals with spatial ordering, soft transitions, and character or word splitting.
text-reveal
GSAP Text
A cinematic kinetic typography component that creates a layered 3D depth effect using continuous vertical text motion.
gsap-text
Hero Backgrounds
10Neon Mesh BG
A dark cinematic WebGL background with an evolving purple neon mesh, fine pixel matrix, and soft atmospheric bloom.
neon-mesh-bg
Silk Aurora
Premium WebGL hero background with satin-dark aurora ribbons, pearlescent highlights, fine grain, and cursor depth.
silk-aurora
Sunlight Effect
Animated multi-color rays radiating from a bright central glow, with adjustable density, reach, bloom, and motion.
sunlight-effect
Soft Fluid Gradient
A deep, hypnotic native WebGL background with an enormous looping ribbon of dark color and fluid illumination.
soft-fluid-gradient
Ink Flow
Slow native WebGL pigment flow inspired by fountain-pen ink dispersing through warm watercolor paper.
ink-flow
Character Field
A dense ambient surface of monospace glyphs that mutate independently on canvas.
character-field
Spectra Noise
Luminous aurora folds with soft teal halos, pale green edges, fine grain, and moving scanlines.
spectra-noise
Noiser
A crisp procedural SVG noise overlay with Gaussian, uniform, and colorized grain for hero backgrounds.
noiser
Liquid Chrome
Premium fluid liquid metal shader background effect.
liquid-chrome
Pixel Flow
Flowing violet light rendered through a fine, animated dithered pixel field.
pixel-flow
Visual Effects
17Focus Carousel
An infinite, horizontally centred media gallery where one sharp card holds focus while neighbours shrink, desaturate, and blur as a continuous function of distance.
focus-carousel
Ambient Strip
A horizontal portrait strip that expands the active frame while a blurred, full-bleed copy of the same artwork crossfades behind it — drag, wheel, keyboard, and center-snap on touch.
ambient-strip
Lens Drift Grid
A dense draggable image wall warped as one continuous fisheye surface with weighted momentum and a gentle idle auto-drift.
lens-drift-grid
Cinematic Card Carousel
A cinematic depth-based card gallery — one sharp hero portrait with progressively blurred, compressed neighbors and pointer-driven spring promotion.
cinematic-card-carousel
Scroll Sync Gallery
Full-width pinned image wall — vertical columns travel at different speeds and alternating directions, all driven by one scroll progress.
scroll-sync-gallery
Infinite Image Gallery
A continuously rotating cylinder of image tiles built with CSS 3D transforms, filling the stage with a seamless editorial loop.
infinite-image-gallery
Crumpled Paper Reveal
A faceted paper wad that unfolds into a flat print with creases intact, driven by a procedural WebGL2 spring with hover, click, scroll, and in-view triggers.
crumpled-paper-reveal
Hover Cards
An editorial portrait row that expands the active card over a blurred, full-bleed image backdrop.
hover-cards
Pixel Wipe Carousel
An editorial image carousel with fast right-to-left mosaic wipes that resolve into crisp stills.
pixel-wipe-carousel
Profile Carousel
An editorial team carousel with full portrait cards, one traveling profile detail card, edge clipping, and seamless looping.
profile-carousel
Scroll Reveal Image
A scroll-scrubbed image sequence where each new frame arrives in a centered window before taking over the backdrop.
scroll-reveal-image
Scroll Media Expand
A cinematic scroll zoom reveal that expands a compact media capsule into a fullscreen scene while surrounding text fades away.
scroll-media-expand
Burn Plus
A WebGL organic burn/dissolve mask — warped multi-octave noise eats through a dark surface to reveal your media, driven by hover, scroll, tap, load, or direct control.
burn-plus
Services Showcase
A layered portrait stack that unfolds on hover, tap, or keyboard activation, with subtle pointer depth and a display-only animated preview.
services-showcase
Segmented Image Carousel
A monochrome editorial carousel that rebuilds every image through a staggered grid of horizontal slices.
segmented-image-carousel
Vertical Image Marquee
A seamless vertical editorial image strip with generous monochrome gutters and a theme-aware light or dark stage.
vertical-image-marquee
Editorial Image Stack
A large fixed center photograph with a fast blur-crossfade, framed by a tight, subdued stack that shuffles in sync.
editorial-image-stack
Preloaders
10Premium Preloader
A theme-aware editorial curtain with a three-line tagline, a centered DAVINCIUI wordmark, and mirrored streams of portrait cards.
premium-preloader
Pixel Preloader
A fullscreen pixel-grid loader that takes over the viewport bottom-up behind a jagged orange frontier, with a top-left finish.
pixel-preloader
Fill Preloader
A fullscreen bottom-up blue fill loader with a giant bottom-right percentage counter and a vertical slide-away reveal.
fill-preloader
Preloader Pro
A cinematic two-stage loader: heavy percentage with a thin red line on white, then a sliding panel reveal into a dark PRELOADER PRO hero.
preloader-pro
Preloader Pro V1
A cinematic strip preloader: drifting portrait cards on near-black, a zero-padded counter, random glitch bursts, and a sliced-shred RGB exit.
preloader-pro-v1
Preloader Pro V4
A theme-aware seven-card editorial preloader with a rising pile, fanned arc, percentage counter, centre-card lift, and a full-bleed 16:9 image expansion.
preloader-pro-v4
Preloader Pro V5
A cinematic image preloader with masked typography, a seven-card 3D arc, featured full-bleed expansion, and split, lift, or iris reveals.
preloader-pro-v5
Staircase Preloader
A fullscreen orange stepped-curtain loader that exits upward with a left-to-right staircase edge and a top-right finish.
staircase-preloader
Geometric Preloader
A fullscreen geometric loader with nested rotating squares and a diamond-scale reveal.
geometric-preloader
Editorial Wipe Preloader
A fullscreen forest-to-cream horizontal wipe with a giant split-tone counter and a vertical slide-away reveal.
editorial-wipe-preloader
Interactions
15Circular Gallery
A cinematic 3D carousel of curved media panels orbiting on a themed stage, with drag, momentum, wheel, and click-through.
circular-gallery
Arcwave Carousel
An infinite CSS-3D carousel with cards wrapped around the inside of a cylinder, featuring depth blur, drag, snap, autoplay, captions, and video.
arcwave-carousel
Streamline Carousel
An infinite WebGL carousel on a single canvas; the flat centre stays level while cards grow taller at the edges and the strip bows outward, with an edge chromatic fringe that strengthens with speed. Drag, wheel, keyboard, click-to-focus, autoplay, and video built in.
streamline-carousel
Depth Carousel 3D
An infinite 3D carousel in plain DOM and CSS 3D transforms; the active card sits centred and flat while neighbours fan out smaller, rotated, and pushed back in Z, swinging edge-on and disappearing. Frosted-glass edge blur, drag, swipe, wheel, keyboard, and click-to-focus built in.
depth-carousel-3d
Curve Wall
A full-bleed wall of portrait media bowed into a soft lens, with drag momentum, a shared-wall hover lift, a spotlight vignette, and an in-place media viewer.
curve-wall
Crumpled Paper Reveal
A faceted paper wad that unfolds into a flat print with creases intact, driven by a procedural WebGL2 spring with hover, click, scroll, and in-view triggers.
crumpled-paper-reveal
Tilt Flip Polaroid
A Polaroid print that tilts away from the pointer with a damped 3D spring and flips to a handwritten note on click, tap, or keyboard.
tilt-flip-polaroid
Liquid Reveal Button
A substantial acid-yellow pill CTA with a pointer-driven black liquid reveal — the mask originates at the real cursor position, expands to full cover with spatially-masked two-tone text, then retracts toward the exit point.
liquid-reveal-button
Interactive Media Accordion
Sticky scroll-driven media accordion — each scroll band expands the next card while the rest collapse into pills.
interactive-media-accordion
Glass Scene Dock
A floating glass navigation dock pinned over scroll-driven gradient scenes with zero image dependencies — a travelling glass highlight glides between icons while scrolling crossfades the backdrop. Light/dark aware, photography optional per scene.
glass-scene-dock
Nudge Button
A white pill CTA with a directional nudge interaction — concentric blue, red, and yellow rings burst from the pointer entry point before a white reveal pushes them out through the clipped edges.
nudge-button
Hover Transition
Eight polished hover transitions with per-card animation, direction, color, and content controls.
hover-transition
Team Slide Reveal
An editorial portrait card with a story sheet that rises into the frame and returns to the profile on demand.
team-slide-reveal
Animated Pill Button
A black pill CTA with a directional liquid wipe — cyan bursts from the right-side dot with a curved leading edge while the dot morphs into an arrow circle and the label flips contrast inside the same mask.
animated-pill-button
Fanned Deck
A 3D fan of up to 14 portrait cards on a curved arc; each card is bent from 14 slices, overlapping 40%, with hover straighten, uncurl, lift, neighbour spread, username bubbles, and deal/flip/rise/sweep entrances.
fanned-deck
Cursor Effects
8Tubes Cursor
A bundle of glowing 3D neon tubes that chases the pointer with fluid inertia and soft bloom. Click to randomize the palette.
tubes-cursor
Electric Vijdi Cursor
A white-hot violet lightning cursor that crackles through recent pointer movement and decays without blocking interaction.
electric-vijdi-cursor
Geometric Trail Cursor
A procedural wireframe cursor history on pure black — pointer movement extrudes twisting chains of outlined polygons, bright at the head and preserved as a long-lived dark geometric skeleton.
geometric-trail-cursor
Chromatic Cursor
A smooth RGB canvas cursor with glowing, independently customizable color trails.
chromatic-cursor
Magic Cursor Pro
A spring-driven outlined cursor with tactile click feedback, blend-mode contrast, and automatic touch-device disablement.
magic-cursor-pro
Circle Cursor
A single solid orange follower circle with smooth inertia, viewport-wide tracking, and automatic touch-device disablement.
circle-cursor
Elastic Blob Cursor
A soft white blob that chases the pointer with inertia, stretches along the direction of travel, and relaxes back into a circle.
elastic-blob-cursor
Fluid Cursor
A fullscreen GPU fluid simulation where pointer movement injects velocity and spectral dye into liquid light that drifts, curls, and fades into black.
fluid-cursor
Motion
6Radial Fan Deck
An editorial card deck that unfolds from a shared hinge into a full radial fan before folding back into a centered stack.
radial-fan-deck
Motion Hamburger
A premium animated hamburger toggle that morphs into a close icon with SVG path-drawing, elastic rotation, and an optional ring.
motion-hamburger
Liquid Chrome Button
A circular WebGL liquid-metal button with a frosted glass lens, depth reflections, and springy hover feedback.
liquid-chrome-button
Animated Metric
An editorial count-up statistic — the number eases to its exact final figure on viewport entry, with a subtle rise-and-fade entrance and a screen-reader-friendly final value.
animated-metric
Wave Bars Loader
A deterministic 4-bar traveling-wave loader with mint bars morphing through descending, flat, and ascending states.
wave-bars-loader
Bookshelf
A 3D bookshelf carousel with real book geometry — spines, covers, and thickness — that rotate into view with coordinated horizontal movement and perspective depth.
bookshelf
Actions
5Button
Versatile buttons with variants, sizes, loading states, and as-child link rendering.
button
Button Group
Joined button segments sharing borders for toolbars and split actions.
button-group
Link
Typographic links with variants, underline treatments, and icon support.
link
Toggle
Two-state pill buttons with pressed styling and size variants.
toggle
Toggle Group
A set of two-state buttons for single or multiple selection with full keyboard support.
toggle-group
Data Display
11Attachment
File and image attachments with media, metadata, upload states, actions, and triggers.
attachment
Avatar
Identity circles with sizes, presence badges, generative fallbacks, and auto-collapsing groups.
avatar
Badge
Pills with nine tones, three sizes, status dots, and removable chips.
badge
Bubble
Conversational message bubbles with variants, alignment, grouping, and edge-anchored reactions.
bubble
Card
Displays a card with header, content, and footer.
card
Chart
Beautiful charts built on Recharts v3 with config-driven theming, tooltips, and legends.
chart
Item
Versatile rows with media, title, description, and actions — groupable into lists.
item
Marker
Inline status, system notes, bordered rows, and labeled separators for conversations.
marker
Message
Conversation rows with avatar, alignment, header, and footer around any message surface.
message
Message Scroller
Chat scroll container with turn anchoring, live-edge follow, history preservation, and jumps.
message-scroller
Separator
A visual divider between sections — horizontal by default, vertical inside row layouts.
separator
Feedback
6Alert
Callouts with five unmistakable tones, icon tiles, and action slots.
alert
Empty
Empty states with media, title, description, and actions for lists, search, and errors.
empty
Progress
Determinate and indeterminate progress bars with sizes and tones.
progress
Skeleton
Content placeholders with shimmer and configurable shapes.
skeleton
Spinner
Loading spinners in five sizes with label support.
spinner
Toast
Stacked notifications with variants, actions, and auto-dismiss.
toast
Forms
17Calendar
A dependency-free date picker with single and range selection, Jalali and Hijri calendar systems, time selects, presets, booked dates, week numbers, and full RTL support.
calendar
Checkbox
Checkboxes with indeterminate state, descriptions, and invalid styling.
checkbox
Combobox
An autocomplete dropdown with single and multiple selection, chips, grouped collections, custom rows, keyboard navigation, and RTL — dependency-free.
combobox
Date Picker
An input-anchored single-date picker with presets, time selects, booked dates, popup placement, and RTL — built on Calendar, dependency-free.
date-picker
Field
Compound form primitives — labels, descriptions, errors, groups, and layouts that compose around any control with shared ids and invalid state.
field
Form
Validated forms with field wiring, error display, and submit handling.
form
Input
Text inputs with variants, invalid states, icons, and full RTL support.
input
Input Group
Compound field with dockable addons — icons, text, buttons, and hints arranged inline or stacked around an input or textarea.
input-group
Input OTP
One-time code input with per-digit slots, paste-to-fill, patterns, separators, completion callback, and RTL.
input-otp
Label
Accessible form labels with proper control association and styling.
label
Native Select
A styled native select with grouped options, invalid and disabled states, and RTL — the OS picker on mobile, zero JavaScript.
native-select
Questionnaire
A multi-step questionnaire with single-choice, multiple-choice, freeform, and skippable questions.
questionnaire
Radio
Radio options with grouped layouts, descriptions, and invalid styling.
radio
Select
Custom dropdown selects with search, grouping, and keyboard navigation.
select
Slider
Pointer and keyboard multi-thumb slider with range fill, vertical layout, controlled values, and RTL mirroring.
slider
Switch
Toggle switches with sizes, labels, and smooth thumb motion.
switch
Textarea
Multiline text inputs with auto sizing, invalid states, and RTL support.
textarea
Layout
6CMS Media Bento
A CMS-ready media bento whose weighted slicing tree re-solves the whole composition around the tile you hover. Ten color portraits from the Spiral Media Gallery set, adaptive captions, and a keyboard-friendly lightbox.
cms-media-bento
Accordion
Keyboard-navigable disclosure stacks with animated panels and card layouts.
accordion
Aspect Ratio
Responsive containers that preserve a fixed width-to-height ratio.
aspect-ratio
Carousel
A carousel with motion and swipe built using Embla.
carousel
Collapsible
An interactive component which expands/collapses a panel.
collapsible
Scroll Area
Augments native scroll functionality for custom, cross-browser styling.
scroll-area
Overlays
9Alert Dialog
A modal interruption that demands acknowledgement — destructive confirmations with focus lock and escape handling.
alert-dialog
Context Menu
A cursor-anchored right-click menu with type-ahead, submenus, checkable states, and viewport-aware flipping. Opens on right-click, Ctrl+click, long-press, or Shift+F10.
context-menu
Dialog
A window overlaid on either the primary window or another dialog window, rendering the content underneath inert.
dialog
Drawer
A drawer component for React. Built on top of Vaul.
drawer
Dropdown Menu
Displays a menu to the user - such as a set of actions or functions - triggered by a button.
dropdown-menu
Hover Card
A hover preview panel with intent delays, four sides, alignment control, keyboard support, and RTL.
hover-card
Popover
Displays rich content in a portal, triggered by a button.
popover
Sheet
A modal side panel docked to any edge with directional motion, header/footer primitives, and RTL.
sheet
Tooltip
A popup that displays information related to an element when the element receives keyboard focus or the mouse hovers over it.
tooltip
Scroll
5Wavy Flow Carousel
An infinite horizontal ribbon of portrait media rendered in one WebGL canvas on your theme background — slides rise and grow taller on the crests, sink and shrink on the troughs, auto-scroll, drag with momentum, and answer the wheel.
wavy-flow-carousel
Curved Inline Type
A sticky scroll stage where headline lines ride an invisible vertical drum, rising, flattening, and fading over the top with images and looping videos inline between words.
curved-inline-type
Scroll Timeline
Pinned fullscreen year timeline — vertical scroll collapses each panel horizontally via clip-path while the oversized year rotates around its bottom-left anchor, exposing the next era underneath.
scroll-timeline
CMS Scroll Gallery
Sticky fullscreen scroll gallery — long page scroll drives synchronized media + title transitions with a draggable glass strip.
cms-scroll-gallery
Stacked Scroll Gallery
Pinned layered media stack — the next panel rises from below and physically covers the current one, driven directly by scroll.
stacked-scroll-gallery

