Sticker Roll Preloader
A rolling 0–100 counter with stickers you stamp as it loads.
React and Framer Components
Features
- •Mechanical odometer counter — The units reel rolls continuously while tens and hundreds tick over, and extra digits slide in as the number grows (1 → 10 → 100).
- •Interactive sticker trail — Visitors stamp springy die-cut stickers as they move the cursor or tap; on phones the trail draws itself. Ships with an 11-piece space set, a bright pop set, and takes your own images.
- •Any Google Font — Inter Regular by default. Name any Google Font and it loads automatically; digit slots are measured from the font's real glyphs, so even script and display faces fit without clipping.
- •8 exit reveals — 5- and 8-column curtains, horizontal and vertical splits, iris, zoom-dissolve, slide-up and fade.
- •Responsive to its container — Digit and sticker sizes are set for a 1440px-wide screen and scale smoothly with the container, from a 320px phone to an ultrawide monitor, never growing past your chosen size or overflowing.
- •Accessible and production-ready — Announced as a progress bar to screen readers; with reduced motion, stickers fade and the exit becomes a gentle fade. Locks page scroll, pauses offscreen, caps live stickers, cleans up every timer, and can show once per session.
Props API Reference
28 configurable props| Prop | Type | Default | Description |
|---|---|---|---|
| speed | "ultra-slow" | "very-slow" | "slow" | "medium" | "fast" | number | "very-slow" | Count duration preset (15s / 10s / 8s / 5.5s / 3.5s), or an exact number of seconds. |
| easing | "ease-out" | "linear" | "ease-in-out" | "ease-out" | How the count accelerates. Ease-out settles slowly onto 100. |
| holdDuration | number | 1.5 | Seconds the counter rests on 100 before the exit starts. |
| exitStyle | "curtain-5" | "curtain-8" | "split-horizontal" | "split-vertical" | "iris" | "zoom-dissolve" | "slide-up" | "fade-out" | "curtain-5" | The reveal animation that uncovers your site. |
| exitDuration | number | 0.65 | Seconds for the exit reveal. |
| backgroundColor | string | "#EAEDF0" | Preloader backdrop color. Any CSS color, including 8-digit hex with transparency. |
| counterColor | string | "#111116" | Color of the rolling digits. |
| counterFormat | "dynamic" | "padded" | "three-digit" | "dynamic" | Dynamic grows 1 → 2 → 3 digits; padded shows 00; three-digit shows 000. |
| counterSuffix | string | "" | Optional text after the number, e.g. "%". |
| counterAlign | "left" | "center" | "right" | "right" | Where the counter sits along the bottom edge. |
| counterFontSize | number | 240 | Digit size in px on a 1440px-wide screen; it scales down with narrower screens and never overflows. |
| googleFont | string | undefined | Any Google Fonts family, e.g. "Space Mono", loaded automatically. This downloads the font from Google, which shares visitors' IP addresses with Google; where privacy rules (such as GDPR) require self-hosting, load the font yourself and use fontFamily instead. |
| fontFamily | string | "Inter" | CSS font stack for fonts you load yourself, e.g. with next/font. Defaults to Inter (your next/font --font-inter variable if set), falling back to the system sans-serif. Ignored when googleFont is set. |
| fontWeight | number | 400 | Digit font weight. With googleFont, only this weight is downloaded. |
| letterSpacing | number | -0.04 | Space between digits in em; negative pulls them together. |
| lineHeight | number | 1.15 | Minimum height of each digit row in em. Rows grow automatically for tall fonts. |
| stickerSet | "space" | "pop" | "space" | Built-in stickers: space (orange, black and holographic) or pop (bright cartoon). |
| stickers | string[] | [] | Your own sticker image URLs (SVG, PNG, WebP…), stamped before the built-in set. |
| builtInStickers | boolean | true | Mix the built-in set in with your stickers. Turn off to stamp only your own. |
| stickerSize | number | 120 | Sticker size in px on a 1440px-wide screen; it scales down with narrower screens. |
| stickerLifetime | number | 1 | Seconds each sticker stays before peeling away. |
| autoTrail | "touch" | "always" | "off" | "touch" | Draw the sticker trail automatically on touch devices, always (when the cursor is idle), or never. |
| fullscreen | boolean | true | Cover the viewport, or fill the nearest positioned parent when false. |
| lockScroll | boolean | true | Prevent page scrolling while the preloader is visible (fullscreen only). |
| showOncePerSession | boolean | false | Skip the preloader on later page loads in the same browser session. |
| zIndex | number | 9999 | Stack order above your page. |
| onComplete | () => void | undefined | Called after the exit reveal finishes (or immediately when skipped). |
| className | string | undefined | Classes for the root element. |