# 3D Product Card

3D Product Card is a Premium standalone component from AI Canvas (https://aicanvas.me): it belongs to no design system and works in any React + Tailwind app. Index of every component and install setup: https://aicanvas.me/llms.txt

An e-commerce product card with a real WebGL turntable. At rest it's a normal shop card (product, name, price, add-to-cart); hovering tilts the card into a 3D display floor while the product lifts and spins so shoppers can inspect it from any angle. Drag to orbit, pick a finish swatch to recolor the upholstery live, drop in your own .glb, adapts to light and dark themes.

- Category: Cards & Modals
- Built with: Three.js, Tailwind CSS
- License: Premium (proprietary, not in the public repo)
- Page: https://aicanvas.me/components/3d-product-card

## Install

```bash
npx shadcn@latest add @aicanvas/3d-product-card
```

Requires Premium. Set your AI Canvas token as AICANVAS_TOKEN and register the @aicanvas registry with it, as described in the Install section of https://aicanvas.me/llms.txt. Without a Premium token the command writes a placeholder (a `PremiumLocked` notice) instead of the component.

AI agents can also get its install command from the read-only AI Canvas MCP server (`npx -y @aicanvas/mcp`) and run it. Setup: https://aicanvas.me/mcp

Peer dependencies:

```bash
npm install three @types/three
```

## Use it

It installs to `components/aicanvas/3d-product-card.tsx` (under `src/` if your project has one). With the usual `@/` alias:

```tsx
import Product3DCard from '@/components/aicanvas/3d-product-card'

<Product3DCard />
```

## Props

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `tag?` | `string` | `'NEW'` | Corner badge label shown on the card. |
| `brand?` | `string` | `'NORDHAUS'` | Brand line above the product name. |
| `name?` | `string` | `'Lyra Lounge Chair'` | Product name heading. |
| `price?` | `string` | `'$420'` | Price label shown beside the name. |
| `model?` | `string` |  | Same-origin or CORS-enabled GLB URL; defaults to Khronos "Sheen Chair" from glTF-Sample-Assets (CC0). |
| `finishes?` | `{name: string, hex: string}[]` | `DEFAULT_FINISHES` | Finish swatches; each tints the dominant material, first is shown at rest. |
| `onAddToCart?` | `() => void` |  | Called when the Add to cart button is pressed. |
| `onWishlistToggle?` | `(wished: boolean) => void` |  | Called with the next wishlist state when the heart is toggled. |
| `className?` | `string` |  | Extra classes merged onto the outermost root element. |

## About

3D Product Card turns a normal shop listing into an interactive turntable. At rest it reads like any product card, with a name, price, wishlist, and add-to-cart button, but hovering tilts the card into a 3D display floor while the product itself lifts and slowly spins, and shoppers can drag to orbit it and study every angle. It loads a real glTF/.glb model so you can drop in your own product, fits any model to frame automatically, and adapts to both light and dark themes. The copy and call-to-action stay flat and readable in 2D while the card leans behind them. Built with raw Three.js.

Use cases: Product page, Online store, 3D showcase.

## Source

The source is Premium and is not published. Preview it at https://aicanvas.me/components/3d-product-card.

## Remix prompt

Only when the user wants 3D Product Card rebuilt from scratch instead of installed: the public part of its remix prompt is in the Remix panel at https://aicanvas.me/components/3d-product-card.

## Related

- [Mood Tracker](https://aicanvas.me/components/mood-tracker.md): A feelings check-in card with six expressive faces. Drag the segmented slider and the face, label, and liquid color wash shift with your mood.
- [Interactive Card Stack](https://aicanvas.me/components/interactive-card-stack.md): A scattered stack of photo cards. Drag, click, or arrow keys to focus any card.
- [Product Card Deck](https://aicanvas.me/components/product-card-deck.md): A draggable card deck you flick through one card at a time. The top card leans toward your drag, then spins away with momentum to reveal the next, and the deck loops endlessly. Every card pairs a picture with a title and a pill action button with hover and press states.
- [Tilted Coverflow](https://aicanvas.me/components/tilted-coverflow.md): 3D coverflow card carousel of seven tilted photos. Drag or arrows to focus any card.
- [New Project Modal](https://aicanvas.me/components/new-project-modal.md): A pill button that morphs into a soft-UI project creation form: title, description, 7-swatch color label picker, Private toggle, and a checkmark-confirm Create button.
