Image Scroll Preloader
Two image columns scroll up, then part to reveal your page.
Features
- •Editorial motion — Staggered image columns glide upward on a luxury ease while a quiet percentage counter climbs the centre of the screen.
- •Your images — Any number of images per column, any aspect ratio, with adjustable width, spacing, side padding and start offsets.
- •Six reveals — Vertical split, center split, wipe up, slide down, zoom and blur, or fade out.
- •Sized to its box — Layout and scroll distance follow the preloader's own size rather than the window, so it works fullscreen, inline and in Framer alike.
- •Your typography — Any Google Font for the counter, with weight, size, line height, letter spacing, colour, padding and suffix.
- •Production ready — Locks page scroll while it plays, pauses offscreen and resumes where it left off, can show once per visit, reports progress to screen readers and fades simply with reduced motion.
Props API Reference
25 configurable props| Prop | Type | Default | Description |
|---|---|---|---|
| leftImages / rightImages | string[] | 2 photos each | Image URLs for each column, top to bottom. |
| speed | "hyper" | "fast" | "editorial" | "relaxed" | number | "editorial" | Count duration preset (1.6 / 2.4 / 3.4 / 4.6 s) or exact seconds. |
| holdDuration | number | 0.3 | Seconds to rest on 100 before the reveal. |
| exitStyle | "vertical-split" | "center-split" | "wipe-up" | "slide-down" | "zoom-blur" | "fade-out" | "vertical-split" | How the page is revealed. |
| exitDuration | number | 0.95 | Seconds for the reveal. |
| googleFont | string | undefined | Any Google Fonts family for the counter, loaded automatically. |
| fontFamily | string | Inter stack | CSS font stack for fonts you load yourself (when googleFont is empty). |
| fontWeight | number | 600 | Counter weight. |
| counterFontSize | number | 13 | Counter size in px at 1440px wide; scales down a little on smaller screens. |
| lineHeight / letterSpacing | number | 1 / 0.1 | Line height and letter spacing in em. |
| counterColor | string | "#111116" | Counter colour. |
| counterFormat | "unpadded" | "padded" | "unpadded" | "0%" or "00%". |
| counterSuffix | string | "%" | Text after the number. |
| counterStart / counterEnd | number | 92 / 8 | Where the counter starts and ends, in % from the top. |
| columnWidth | number | 72 | Image width as a share of each half, in %. |
| aspectRatio | number | 1 | Image width ÷ height. |
| sidePadding | number | 64 | Largest gap from the outer edge to the images, in px. |
| cardGap | number | 120 | Vertical gap between images, as % of the height. |
| leftOffset / rightOffset | number | 6 / 58 | Where each column starts, as % of the height. |
| backgroundColor | string | "#FFFFFF" | Background of both halves. |
| fullscreen | boolean | true | Cover the viewport, or fill the nearest positioned parent. |
| lockScroll | boolean | true | Stop the page scrolling while it plays (fullscreen only). |
| showOncePerSession | boolean | false | Skip it after the first visit in a browser session. |
| zIndex | number | 9999 | Stacking order. |
| onComplete | () => void | undefined | Called once the reveal finishes (or right away when skipped). |