Premium Preloader
A theme-aware editorial curtain with a three-line tagline, a centered DAVINCIUI wordmark, and mirrored streams of portrait cards.
Installation#
pnpm dlx shadcn@latest add @davinciui/premium-preloaderUsage#
API Reference#
| Prop | Type | Default |
|---|---|---|
sequenceChoreography order. The logo leads in the first; the card streams lead in the second. | "logo-images" | "images-logo" | "logo-images" |
taglineLines rendered as stacked blurred words before the logo appears. | string[] | ["Copy", "Paste", "Ship"] |
logoOptional logo image. When omitted, the typeset DAVINCIUI wordmark renders as text. | string | — |
imagesCard image sources, cycled in order across both mirrored streams. | string[] | — |
themeFollows the website theme live, or forces the light or dark palette. | "auto" | "light" | "dark" | "auto" |
backgroundPaper color for both curtain panels; overrides the theme palette. | string | theme palette |
textColorLogo and tagline ink; overrides the theme palette. | string | theme palette |
disableOnMobileSkip the fullscreen overlay below the mobile breakpoint. | boolean | false |
mobileBreakpointCutoff in CSS pixels for disableOnMobile. | number | 810 |
playOnceRemember completion per path in sessionStorage and skip subsequent mounts. | boolean | false |
modeFixed viewport overlay or absolutely positioned stage for cards and previews. | "fullscreen" | "preview" | "fullscreen" |
loopRestart automatically after each reveal. | boolean | false |
loopHoldMilliseconds the revealed page holds before looping. | number | 900 |
onCompleteFires after the curtains finish, and after every loop pass. | () => void | — |
refForwarded ref exposing replay(sequence?) for imperative restarts. | PremiumPreloaderHandle | — |
Accessibility#
A role status with aria-label Loading announces only the overlay state; the tagline, wordmark, marks, and cards are aria-hidden decoration. Fullscreen mode locks scroll and marks background branches inert until the reveal, then restores them exactly. There are no focusable controls, and reduced-motion users get a short fade instead of the sequence.
Motion#
One GSAP timeline runs both sequences: three tagline words blur upward, then either the wordmark leads or 20 cards fly along mirrored quadratic paths with a 0.145s stagger before the logo lands at 3.1s. The right panel slides down and the left panel up, and fonts plus the first three images gate playback for at most 1.5s. matchMedia reduced motion skips the choreography and fades the overlay in 0.4s.
Behavior#
- Sequences —
logo-imagesintroduces the mark before the streams;images-logoruns the streams first and lands the logo last. - Replay — the forwarded ref exposes
replay(sequence?). Each call builds a fresh timeline from a clean first frame. - Modes —
fullscreenlocks scroll and inerts the page behind it;previewstays inside its positioned parent for cards and docs stages. - Mobile — set
disableOnMobileto skip the overlay below 810px, or passmobileBreakpointto change the cutoff. - Theme —
autofollows the website light or dark theme live; passlightordarkto force a palette. Explicit background and textColor props still win. - Reduced motion — the full sequence collapses to a 0.4s fade with no card travel.
Best For#
Component libraries, design systems, and product launches where the first paint should feel like an editorial title card rather than a progress bar.
View source
Keep in mind
Need a custom component?
I build bespoke UI components & websites tailored to your brand.

