Portfolio Showcase
An edge-to-edge continuous infinite canvas in an organic masonry waterfall layout engineered for creative agencies, design studios, and freelance portfolios.
The component pairs smooth 4-directional inertial drag physics (touch, trackpad, and mouse) with an ambient floating drift and automatic camera flights that glide gracefully from card to card. Clicking any project card opens a high-fidelity modal detailing project specifications, deliverables, and interactive action triggers.
Masonry Portfolio — variant="masonry-portfolio"
Pass variant="masonry-portfolio" for an edge-to-edge continuous infinite canvas in a masonry layout. Click & drag anywhere in all 4 directions with smooth momentum physics and ambient floating drift — it wraps infinitely without ever ending.
- Pass
variant"masonry-portfolio" - Selects the edge-to-edge infinite masonry canvas showcasing all cards with smooth inertial physics and centered 3D ambient elevation.
- Set
draggabletrue - Enables interactive 4-directional mouse and touch dragging with spring physics and kinetic momentum damping.
- Set
intervaltrue - Activates continuous smooth auto-scrolling glide across the infinite 2D canvas, pausing automatically during active user drag interactions and project modal inspection.
- Set
intervalTime5500 - Configures how long the camera settles on a project card in milliseconds before initiating flight to the next.
- Set
order"shuffle" - Takes flights in dynamic multi-directional paths across the masonry canvas rather than a single fixed axis.
- Set
stagger72 - Controls the vertical masonry offset between alternate columns, producing an organic waterfall layout where cards do not align rigidly.
- Set
gap16 - Specifies the uniform spacing between adjacent cards in pixels.
- Set
itemModaltrue - Opens the high-resolution project modal upon card selection, providing media zoom, client metadata, deliverables, and external actions.
Installation
New project? Follow the installation guide to set up Tailwind CSS, shadcn, the cn helper and lucide-react, register the @avara-ui registry once, then copy your styles from the Themes page.
Install Portfolio Showcase
components/ is written into your project. Copy any snippet from a Usage tab above and it runs.
Install dependencies
Step 1 installs these for you. Run them yourself only if you are adding Portfolio Showcase to an existing project by hand. The cn helper and lucide-react are not listed — the installation guide covers them once for every component.
button and modal are components, not packages — the shadcn CLI installs them as source files.
Features
Discover the key capabilities that make Portfolio Showcase the ultimate display engine for creative work.
2D Infinite Canvas
Cards seamlessly wrap around all 4 screen boundaries with zero stutter or boundaries, creating an uninterrupted endless browsing experience.
Inertial Momentum Physics
Natural kinetic friction and velocity tracking respond to mouse flings and touch swipes, smoothly decelerating like a physical surface.
Organic Masonry Stagger
Configurable column offsets produce an asymmetric waterfall composition that highlights projects without rigid row constraints.
Rich Project Inspection Modal
Clicking any work card pops open an accessible, responsive presentation dialog with client specs, deliverables, and live project triggers.
Props Reference
| Prop | Type | Default | Description |
|---|---|---|---|
variant | "masonry-portfolio" | "fullscreen" | "masonry-portfolio" | Layout presentation style. Defaults to "masonry-portfolio" with 3D ambient center cushion and edge-to-edge canvas. |
items | PortfolioItem[] | DEFAULT_PORTFOLIO_ITEMS | Array of project objects containing title, image, category, client, year, and description. |
draggable | boolean | true | Enables 4-way mouse, trackpad, and touch panning across the entire canvas with kinetic inertia. |
interval | boolean | number | true | Controls automatic canvas animation. When true (or duration in ms), triggers smooth continuous auto-scrolling glide across the infinite 2D canvas. Set to false to keep the canvas stationary. |
drift | boolean | { x?: number; y?: number } | { x: -0.35, y: -0.18 } | Custom continuous ambient auto-scroll velocity vector. Defaults to { x: -0.35, y: -0.18 } when interval=true. Pass false to disable auto-drift or specify custom velocity. |
intervalTime | number | 5500 | Duration in milliseconds the camera settles on a card before transitioning to the next destination. |
order | "serial" | "shuffle" | "shuffle" | Camera path sequence: sequential ordering or non-linear multi-directional random flights. |
stagger | number | 72 | Vertical masonry displacement in pixels between alternating column tracks. |
gap | number | 16 | Spacing in pixels between adjacent cards horizontally and vertically. |
zoom | number | 0.55 | Scale multiplier for resting cards on desktop viewports (compact & refined view). |
mobileZoom | number | 0.42 | Scale multiplier for cards rendered on compact mobile displays. |
itemModal | boolean | true | When true, clicking any card launches the comprehensive project details dialog. |
cardShadow | boolean | true | Renders subtle realistic drop shadows beneath each project card. |
highlightFocus | boolean | false | When true, selectively highlights the active card while subtly dimming outer cards. |