motion-ui-skill 2.0.0 → 2.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +71 -21
- package/SKILL.md +83 -9
- package/bin/index.mjs +2 -2
- package/bin/installer.mjs +6 -0
- package/catalog.json +1044 -139
- package/components/agents/thinking-states.tsx +156 -0
- package/components/buttons/aqua-button.tsx +145 -0
- package/components/buttons/ash-burst-button.tsx +528 -0
- package/components/buttons/brutal-button.tsx +68 -0
- package/components/buttons/chrome-button.tsx +444 -0
- package/components/buttons/click-powerup.tsx +203 -0
- package/components/buttons/command-button.tsx +226 -0
- package/components/buttons/confetti-button.tsx +132 -0
- package/components/buttons/cooldown-button.tsx +169 -0
- package/components/buttons/demonic-button.tsx +470 -0
- package/components/buttons/dither-button.tsx +192 -0
- package/components/buttons/doubt-button.tsx +240 -0
- package/components/buttons/evil-eye-button.tsx +563 -0
- package/components/buttons/frame-button.tsx +211 -0
- package/components/buttons/glitch-button.tsx +243 -0
- package/components/buttons/highlight-button.tsx +196 -0
- package/components/buttons/hold-button.tsx +245 -0
- package/components/buttons/minecraft-button.tsx +651 -0
- package/components/buttons/minimal-button.tsx +50 -0
- package/components/buttons/morph-status-button.tsx +264 -0
- package/components/buttons/movie-pass-button.tsx +205 -0
- package/components/buttons/realistic-switch.tsx +298 -0
- package/components/buttons/reveal-button.tsx +197 -0
- package/components/buttons/shiny-button.tsx +87 -0
- package/components/buttons/slide-to-detonate.tsx +444 -0
- package/components/buttons/sticky-button.tsx +184 -0
- package/components/buttons/thruster-button.tsx +920 -0
- package/components/buttons/troll-button.tsx +264 -0
- package/components/motion/banner-stacking.tsx +124 -0
- package/components/motion/delete-with-smoky-dissolve.tsx +145 -0
- package/components/motion/donut-chart.tsx +112 -0
- package/components/motion/drag-drop-with-physics.tsx +116 -0
- package/components/motion/dropdown-menu-morph.tsx +157 -0
- package/components/motion/get-pro-button.tsx +54 -0
- package/components/motion/image-open-tilt.tsx +79 -0
- package/components/motion/input-clear-with-dissolve.tsx +111 -0
- package/components/motion/learn-more-hover.tsx +71 -0
- package/components/motion/matrix-dot-loader.tsx +68 -0
- package/components/motion/organic-shimmer.tsx +49 -0
- package/components/motion/pro-gradient-text.tsx +46 -0
- package/components/motion/skeleton-loader-and-reveal.tsx +81 -0
- package/components/motion/spinner-to-check-morph.tsx +99 -0
- package/components/motion/spinning-counter.tsx +64 -0
- package/components/motion/text-morph.tsx +80 -0
- package/components/motion/texts-reveal.tsx +49 -0
- package/data/app-interface.csv +33 -0
- package/data/charts.csv +26 -0
- package/data/colors.csv +193 -0
- package/data/google-fonts.csv +1935 -0
- package/data/icons.csv +106 -0
- package/data/landing.csv +35 -0
- package/data/motion.csv +18 -0
- package/data/products.csv +193 -0
- package/data/react-performance.csv +45 -0
- package/data/stacks/angular.csv +51 -0
- package/data/stacks/astro.csv +54 -0
- package/data/stacks/avalonia.csv +57 -0
- package/data/stacks/flutter.csv +53 -0
- package/data/stacks/html-tailwind.csv +60 -0
- package/data/stacks/javafx.csv +76 -0
- package/data/stacks/jetpack-compose.csv +53 -0
- package/data/stacks/laravel.csv +51 -0
- package/data/stacks/nextjs.csv +62 -0
- package/data/stacks/nuxt-ui.csv +77 -0
- package/data/stacks/nuxtjs.csv +68 -0
- package/data/stacks/react-native.csv +52 -0
- package/data/stacks/react.csv +67 -0
- package/data/stacks/shadcn.csv +69 -0
- package/data/stacks/svelte.csv +56 -0
- package/data/stacks/swiftui.csv +51 -0
- package/data/stacks/threejs.csv +54 -0
- package/data/stacks/uno.csv +60 -0
- package/data/stacks/uwp.csv +56 -0
- package/data/stacks/vue.csv +50 -0
- package/data/stacks/winui.csv +60 -0
- package/data/stacks/wpf.csv +57 -0
- package/data/styles.csv +89 -0
- package/data/typography.csv +75 -0
- package/data/ui-reasoning.csv +193 -0
- package/data/ux-guidelines.csv +120 -0
- package/evals/catalog_eval.py +56 -0
- package/icons/annotations/loop-arrow.tsx +61 -0
- package/icons/brands/anthropic.tsx +26 -0
- package/icons/brands/apple.tsx +26 -0
- package/icons/brands/canva.tsx +26 -0
- package/icons/brands/claude-ai.tsx +26 -0
- package/icons/brands/discord.tsx +26 -0
- package/icons/brands/github.tsx +26 -0
- package/icons/brands/gmail.tsx +26 -0
- package/icons/brands/google.tsx +26 -0
- package/icons/brands/linkedin.tsx +29 -0
- package/icons/brands/microsoft.tsx +26 -0
- package/icons/brands/next-js.tsx +26 -0
- package/icons/brands/producthunt.tsx +26 -0
- package/icons/brands/react-js.tsx +29 -0
- package/icons/brands/shadcn-ui.tsx +26 -0
- package/icons/brands/tailwind-css.tsx +26 -0
- package/icons/brands/twitter.tsx +30 -0
- package/icons/brands/typescript.tsx +26 -0
- package/icons/brands/unsplash.tsx +27 -0
- package/icons/brands/vercel.tsx +26 -0
- package/icons/brands/whatsapp.tsx +26 -0
- package/package.json +9 -3
- package/prompts/install-motion-ui.md +17 -0
- package/references/agents/thinking-states.md +56 -0
- package/references/craft/aqua-button.md +53 -0
- package/references/craft/ash-burst-button.md +55 -0
- package/references/craft/brutal-button.md +52 -0
- package/references/craft/chrome-button.md +53 -0
- package/references/craft/click-powerup.md +53 -0
- package/references/craft/command-button.md +53 -0
- package/references/craft/confetti-button.md +54 -0
- package/references/craft/cooldown-button.md +54 -0
- package/references/craft/demonic-button.md +53 -0
- package/references/craft/dither-button.md +52 -0
- package/references/craft/doubt-button.md +53 -0
- package/references/craft/evil-eye-button.md +52 -0
- package/references/craft/frame-button.md +54 -0
- package/references/craft/glitch-button.md +52 -0
- package/references/craft/highlight-button.md +53 -0
- package/references/craft/hold-button.md +53 -0
- package/references/craft/minecraft-button.md +53 -0
- package/references/craft/minimal-button.md +52 -0
- package/references/craft/morph-status-button.md +53 -0
- package/references/craft/movie-pass-button.md +53 -0
- package/references/craft/realistic-switch.md +54 -0
- package/references/craft/reveal-button.md +53 -0
- package/references/craft/shiny-button.md +52 -0
- package/references/craft/slide-to-detonate.md +53 -0
- package/references/craft/sticky-button.md +54 -0
- package/references/craft/thruster-button.md +53 -0
- package/references/craft/troll-button.md +54 -0
- package/references/guides/design-intelligence.md +125 -0
- package/references/guides/interaction-transitions.md +56 -38
- package/references/guides/motion-polish-rules.md +75 -0
- package/references/guides/stack-best-practices.md +38 -0
- package/references/motion/banner-stacking.md +67 -0
- package/references/motion/delete-with-smoky-dissolve.md +60 -0
- package/references/motion/donut-chart.md +79 -0
- package/references/motion/drag-drop-with-physics.md +61 -0
- package/references/motion/dropdown-menu-morph.md +55 -0
- package/references/motion/get-pro-button.md +56 -0
- package/references/motion/image-open-tilt.md +60 -0
- package/references/motion/input-clear-with-dissolve.md +58 -0
- package/references/motion/learn-more-hover.md +56 -0
- package/references/motion/matrix-dot-loader.md +58 -0
- package/references/motion/organic-shimmer.md +63 -0
- package/references/motion/pro-gradient-text.md +57 -0
- package/references/motion/skeleton-loader-and-reveal.md +67 -0
- package/references/motion/spinner-to-check-morph.md +67 -0
- package/references/motion/spinning-counter.md +74 -0
- package/references/motion/text-morph.md +64 -0
- package/references/motion/texts-reveal.md +56 -0
- package/scripts/build_docs.py +39 -4
- package/scripts/core.py +993 -0
- package/scripts/design_system.py +1668 -0
- package/scripts/reasoning_contract.py +123 -0
- package/scripts/search.py +177 -0
- package/scripts/test_release.py +12 -0
- package/scripts/verify_skill.py +4 -4
- package/test/test_installer.mjs +133 -0
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
<div align="center">
|
|
4
4
|
|
|
5
|
-

|
|
6
6
|

|
|
7
7
|

|
|
8
8
|

|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|

|
|
12
12
|
|
|
13
13
|
<p align="center">
|
|
14
|
-
<b>Comprehensive Library of
|
|
14
|
+
<b>Comprehensive Library of 384 Animated React & Next.js UI Components</b><br/>
|
|
15
15
|
Built with Motion and Tailwind CSS. Designed as an offline-first AI Agent Skill & Developer Toolkit with 6 aesthetic style presets.
|
|
16
16
|
</p>
|
|
17
17
|
|
|
@@ -21,12 +21,12 @@
|
|
|
21
21
|
|
|
22
22
|
## Overview
|
|
23
23
|
|
|
24
|
-
**Motion UI Skill** is a production-ready, fully self-contained collection of **
|
|
24
|
+
**Motion UI Skill** is a production-ready, fully self-contained collection of **384 interactive, animated UI components** across four distinct categories:
|
|
25
25
|
|
|
26
|
-
1. **Motion Components (
|
|
27
|
-
2. **AI Agent Surfaces (
|
|
26
|
+
1. **Motion Components (97)**: Micro-interactions, spring-loaded buttons, morphing inputs, bouncily unfolding selects, bottom sheets, virtualized tables, 3D cylinder carousels, 17 loader variants, cascaders, ratings, avatar groups, celebration success checks, rich hover cards, keyboard keycaps, smart password fields, spotlight cards, glow buttons, chronological timelines, steppers, segmented controls, breadcrumbs, pagination, collapsibles, chips, copy buttons, progress rings, tree views, sortable lists, date range pickers, icon stacks, phone inputs, speed dials, color pickers, magnet docks, page transitions, card resizes, error shakes, text swaps, and autocompletes.
|
|
27
|
+
2. **AI Agent Surfaces (18)**: Complete modern conversational agent interfaces including message bubbles, viewport scrollers, expandable prompt composers, human-in-the-loop approval cards, streaming responses, diff viewers, syntax-highlighted code blocks, and adaptive activity streams.
|
|
28
28
|
3. **Blocks & Widgets (33)**: Rich, composable application widgets such as drag-and-drop kanban workflow boards, faceted query filter builders, universal mobile action sheets, Apple-style dynamic islands, ⌘K command palettes, knockout tournament fixtures, weekly availability schedulers, cross-chain swaps, prediction market tickets, morphing tab views, event calendars, gantt timeline charts, resizable split panels, audio players, metric stat cards with sparklines, reorder grids, and browser frame mockups.
|
|
29
|
-
4. **Craft & Surface Components (
|
|
29
|
+
4. **Craft & Surface Components (236)**: Tactile 3D buttons, neumorphic soft UI controls, high-fidelity Apple device mockups (iPhone, MacBook, iPad, Watch, iPod), background gradients & geometric patterns, booking calendars, customer and transaction tables, editorial typography cards, social cards, and interactive widgets.
|
|
30
30
|
|
|
31
31
|
### 🌟 Key Highlights
|
|
32
32
|
- **Local-First**: Every bundled component source file (`.tsx`), shared utility (`lib/`), and markdown guide exists directly in this repository. No remote registry is needed to discover or copy the bundled components.
|
|
@@ -107,7 +107,7 @@ npx skills add Rkj0123/motion-ui-skill --skill motion-ui --agent codex --global
|
|
|
107
107
|
|
|
108
108
|
A standalone Python resolver and installer is included in `scripts/install-component.py`:
|
|
109
109
|
|
|
110
|
-
#### List all
|
|
110
|
+
#### List all 384 components:
|
|
111
111
|
```bash
|
|
112
112
|
python scripts/install-component.py --list
|
|
113
113
|
```
|
|
@@ -154,9 +154,9 @@ Ensure your `tailwind.config.js` or `globals.css` supports CSS variable colors (
|
|
|
154
154
|
|
|
155
155
|
---
|
|
156
156
|
|
|
157
|
-
## Component Catalog (
|
|
157
|
+
## Component Catalog (384 Components)
|
|
158
158
|
|
|
159
|
-
### 1. Motion Components (
|
|
159
|
+
### 1. Motion Components (97)
|
|
160
160
|
|
|
161
161
|
| Component | Slug | Description | Dependencies | Primary File | Docs |
|
|
162
162
|
| :--- | :--- | :--- | :--- | :--- | :--- |
|
|
@@ -170,6 +170,7 @@ Ensure your `tailwind.config.js` or `globals.css` supports CSS variable colors (
|
|
|
170
170
|
| **Aspect Ratio** | `aspect-ratio` | Adaptive aspect ratio container with smooth geometry transitions when switching ratios and zero cumulative layout shift. | `motion` | [`components/motion/aspect-ratio.tsx`](components/motion/aspect-ratio.tsx) | [Guide](references/motion/aspect-ratio.md) |
|
|
171
171
|
| **Autocomplete** | `autocomplete` | Searchable combobox with substring highlighting, keyboard arrow navigation, clear trigger, and spring panel reveal. | `lucide-react`, `motion` | [`components/motion/autocomplete.tsx`](components/motion/autocomplete.tsx) | [Guide](references/motion/autocomplete.md) |
|
|
172
172
|
| **Avatar Group** | `avatar-group` | Interactive stacked avatar pile where hovering an avatar springs it forward while adjacent neighbors fan out with distance falloff. | `motion` | [`components/motion/avatar-group.tsx`](components/motion/avatar-group.tsx) | [Guide](references/motion/avatar-group.md) |
|
|
173
|
+
| **Banner Stacking** | `banner-stacking` | Stackable announcement and toast notification deck where new alerts rise in while older items scale down and recede with spring physics. | `motion` | [`components/motion/banner-stacking.tsx`](components/motion/banner-stacking.tsx) | [Guide](references/motion/banner-stacking.md) |
|
|
173
174
|
| **Bottom Sheet** | `bottom-sheet` | Vaul-inspired draggable bottom sheet with snap points, inertia and glass surface. | `motion`, `react-dom` | [`components/motion/bottom-sheet.tsx`](components/motion/bottom-sheet.tsx) | [Guide](references/motion/bottom-sheet.md) |
|
|
174
175
|
| **Bounce Sidebar** | `bounce-sidebar` | A vertical sidebar whose active dot jumps between destinations on a curved, spring-loaded path. | `motion` | [`components/motion/bounce-sidebar.tsx`](components/motion/bounce-sidebar.tsx) | [Guide](references/motion/bounce-sidebar.md) |
|
|
175
176
|
| **Bouncy Accordion** | `bouncy-accordion` | Single-open accordion with weighted spring layout, icon rows and reduced-motion-safe content reveals. | `lucide-react`, `motion` | [`components/motion/bouncy-accordion.tsx`](components/motion/bouncy-accordion.tsx) | [Guide](references/motion/bouncy-accordion.md) |
|
|
@@ -187,30 +188,41 @@ Ensure your `tailwind.config.js` or `globals.css` supports CSS variable colors (
|
|
|
187
188
|
| **Copy Button** | `copy-button` | One-click clipboard copy button with spring checkmark morph, haptic confirmation, and tooltip feedback. | `lucide-react`, `motion` | [`components/motion/copy-button.tsx`](components/motion/copy-button.tsx) | [Guide](references/motion/copy-button.md) |
|
|
188
189
|
| **Cylinder Carousel** | `cylinder-carousel` | A carousel whose items line the inside of a cylinder, receding into the center and growing toward the edges. Drag, scroll or arrow-key to roll it, with a springy glide and snap. Reduced-motion drops the glide. | `@paper-design/shaders-react`, `motion` | [`components/motion/cylinder-carousel.tsx`](components/motion/cylinder-carousel.tsx) | [Guide](references/motion/cylinder-carousel.md) |
|
|
189
190
|
| **Date Range Picker** | `date-range-picker` | Interactive calendar popover for selecting start and end date ranges with preset shortcuts, month navigation, and spring micro-interactions. | `lucide-react`, `motion` | [`components/motion/date-range-picker.tsx`](components/motion/date-range-picker.tsx) | [Guide](references/motion/date-range-picker.md) |
|
|
191
|
+
| **Delete with Smoky Dissolve** | `delete-with-smoky-dissolve` | Interactive delete button trigger that disintegrates its target element into dissolving smoke particles and embers upon confirmation. | `motion` | [`components/motion/delete-with-smoky-dissolve.tsx`](components/motion/delete-with-smoky-dissolve.tsx) | [Guide](references/motion/delete-with-smoky-dissolve.md) |
|
|
190
192
|
| **Dock** | `dock` | macOS-style dock with grouped actions and a gliding active pill. | `lucide-react`, `motion` | [`components/motion/dock.tsx`](components/motion/dock.tsx) | [Guide](references/motion/dock.md) |
|
|
193
|
+
| **Donut Chart** | `donut-chart` | Animated SVG donut chart whose segments have rounded corners, consistent gaps, and smoothly tween from old values to new values when data changes. | `motion` | [`components/motion/donut-chart.tsx`](components/motion/donut-chart.tsx) | [Guide](references/motion/donut-chart.md) |
|
|
194
|
+
| **Drag Drop with Physics** | `drag-drop-with-physics` | Physics-based drag-and-drop card surface with rotational inertia, velocity preservation, and magnetic slot snapping. | `motion` | [`components/motion/drag-drop-with-physics.tsx`](components/motion/drag-drop-with-physics.tsx) | [Guide](references/motion/drag-drop-with-physics.md) |
|
|
191
195
|
| **Drawer** | `drawer` | Side panel that slides in from the left or right with a spring, backdrop blur, body scroll lock and esc-to-close. | `motion` | [`components/motion/drawer.tsx`](components/motion/drawer.tsx) | [Guide](references/motion/drawer.md) |
|
|
196
|
+
| **Dropdown Menu Morph** | `dropdown-menu-morph` | Fluid navigation menu dropdown whose container geometry, background sheet, and arrow tip morph seamlessly between submenu tabs. | `motion` | [`components/motion/dropdown-menu-morph.tsx`](components/motion/dropdown-menu-morph.tsx) | [Guide](references/motion/dropdown-menu-morph.md) |
|
|
192
197
|
| **Error Shake** | `error-shake` | Damped oscillation shake wrapper with haptic error vibration feedback and configurable intensity for form validations. | `motion` | [`components/motion/error-shake.tsx`](components/motion/error-shake.tsx) | [Guide](references/motion/error-shake.md) |
|
|
193
198
|
| **Expandable Control** | `expandable-control` | Click-to-expand button and chip controls that reveal a label or trailing action through spring layout continuity. | `lucide-react`, `motion` | [`components/motion/expandable-control.tsx`](components/motion/expandable-control.tsx) | [Guide](references/motion/expandable-control.md) |
|
|
194
199
|
| **File Tree** | `file-tree` | Composable file and folder primitives with springing branches, a gliding selection, and complete keyboard navigation. | `lucide-react`, `motion` | [`components/motion/file-tree.tsx`](components/motion/file-tree.tsx) | [Guide](references/motion/file-tree.md) |
|
|
200
|
+
| **Get Pro Button** | `get-pro-button` | High-converting Pro upgrade trigger featuring an animated conic gradient border, ambient chromatic glow, and specular hover sheen. | `motion` | [`components/motion/get-pro-button.tsx`](components/motion/get-pro-button.tsx) | [Guide](references/motion/get-pro-button.md) |
|
|
195
201
|
| **Glow Button** | `glow-button` | Premium CTA button featuring an iridescent glowing perimeter gradient, magnetic pointer attraction, and tactile spring feedback. | `motion` | [`components/motion/glow-button.tsx`](components/motion/glow-button.tsx) | [Guide](references/motion/glow-button.md) |
|
|
196
202
|
| **Haptic Pressable** | `haptic-pressable` | Universal touch-first interactive wrapper with physical spring compression, semantic vibration feedback, and hover guards. | `motion` | [`components/motion/haptic-pressable.tsx`](components/motion/haptic-pressable.tsx) | [Guide](references/motion/haptic-pressable.md) |
|
|
197
203
|
| **Hover Card** | `hover-card` | Rich contextual hover card popover with open/close delay buffering, spring entrance, and collision avoidance. | `motion` | [`components/motion/hover-card.tsx`](components/motion/hover-card.tsx) | [Guide](references/motion/hover-card.md) |
|
|
198
204
|
| **Icon Stack** | `icon-stack` | Overlapping icon and avatar cluster with hover fan-out expansion, spring elevation, and automated tooltip reveals. | `motion` | [`components/motion/icon-stack.tsx`](components/motion/icon-stack.tsx) | [Guide](references/motion/icon-stack.md) |
|
|
205
|
+
| **Image Open Tilt** | `image-open-tilt` | Interactive media lightbox trigger opening an image preview with 3D perspective tilt, depth parallax, and zero layout shift. | `motion` | [`components/motion/image-open-tilt.tsx`](components/motion/image-open-tilt.tsx) | [Guide](references/motion/image-open-tilt.md) |
|
|
199
206
|
| **Input** | `input` | Text input with label, left/right icons, optional stable error row, error shake and success check draw. | `lucide-react`, `motion` | [`components/motion/input.tsx`](components/motion/input.tsx) | [Guide](references/motion/input.md) |
|
|
207
|
+
| **Input Clear with Dissolve** | `input-clear-with-dissolve` | Form input with animated character dissolve dissipation effect that scatters letters with particle blur when clearing. | `motion` | [`components/motion/input-clear-with-dissolve.tsx`](components/motion/input-clear-with-dissolve.tsx) | [Guide](references/motion/input-clear-with-dissolve.md) |
|
|
200
208
|
| **Keyboard Keycap** | `kbd` | Hardware-styled keyboard shortcut cap with OS auto-detection (macOS ⌘ vs Windows Ctrl), key combination joins, and tactile spring press feedback. | `motion` | [`components/motion/kbd.tsx`](components/motion/kbd.tsx) | [Guide](references/motion/kbd.md) |
|
|
209
|
+
| **Learn More Hover** | `learn-more-hover` | Editorial action link with continuous arrow loop trail, underline reveal, and spring overshoot trajectory on hover. | `motion` | [`components/motion/learn-more-hover.tsx`](components/motion/learn-more-hover.tsx) | [Guide](references/motion/learn-more-hover.md) |
|
|
201
210
|
| **Loader** | `loader` | Loading indicator with seventeen variants: spinner, dots, bars, dot-matrix, dither, morph, comet, scramble, metaballs, newton, helix, percent, and five terminal-style ascii spinners. Scales from one size prop, uses currentColor, and reduced-motion swaps every transform for a calm opacity pulse. | `motion` | [`components/motion/loader.tsx`](components/motion/loader.tsx) | [Guide](references/motion/loader.md) |
|
|
202
211
|
| **Magnet Dock** | `magnet-dock` | Interactive application dock whose icons magnify continuously based on pointer proximity using spring physics and motion values. | `motion` | [`components/motion/magnet-dock.tsx`](components/motion/magnet-dock.tsx) | [Guide](references/motion/magnet-dock.md) |
|
|
203
212
|
| **Marquee** | `marquee` | Infinite horizontal or vertical scroll with pause-on-hover. | None (core) | [`components/motion/marquee.tsx`](components/motion/marquee.tsx) | [Guide](references/motion/marquee.md) |
|
|
213
|
+
| **Matrix Dot Loader** | `matrix-dot-loader` | Sci-fi matrix dot grid indicator with synchronized harmonic waves, radial ripple pulses, and binary activity feedback. | `motion` | [`components/motion/matrix-dot-loader.tsx`](components/motion/matrix-dot-loader.tsx) | [Guide](references/motion/matrix-dot-loader.md) |
|
|
204
214
|
| **Morphing Modal** | `morphing-modal` | Family-app-style modal. A single panel that morphs its height as you navigate between inner views, with blur cross-fade on content. | `lucide-react`, `motion` | [`components/motion/morphing-modal.tsx`](components/motion/morphing-modal.tsx) | [Guide](references/motion/morphing-modal.md) |
|
|
205
215
|
| **Multi Select** | `multi-select` | Composable multi-select primitives with searchable options, removable animated tokens, and a morphing collision-aware panel. | `lucide-react`, `motion`, `react-dom` | [`components/motion/multi-select/index.tsx`](components/motion/multi-select/index.tsx) | [Guide](references/motion/multi-select.md) |
|
|
206
216
|
| **Number Animation** | `number` | Animated number primitives for count-up values, rolling tickers, and fixed-slot digit swaps. | `motion` | [`components/motion/animated-number.tsx`](components/motion/animated-number.tsx) | [Guide](references/motion/number.md) |
|
|
207
217
|
| **Number Field** | `number-field` | Precision numeric stepper input with increment/decrement hold acceleration, rolling number animation, and min/max limits. | `lucide-react`, `motion` | [`components/motion/number-field.tsx`](components/motion/number-field.tsx) | [Guide](references/motion/number-field.md) |
|
|
218
|
+
| **Organic Shimmer** | `organic-shimmer` | Organic fluid light sheen moving across card surfaces, adapting dynamically to border radius, tilt angle, and lighting conditions. | `motion` | [`components/motion/organic-shimmer.tsx`](components/motion/organic-shimmer.tsx) | [Guide](references/motion/organic-shimmer.md) |
|
|
208
219
|
| **Page Transition** | `page-transition` | Composable page and view transition container supporting fade, slide, scale, push, and 3D flip modes with AnimatePresence. | `motion` | [`components/motion/page-transition.tsx`](components/motion/page-transition.tsx) | [Guide](references/motion/page-transition.md) |
|
|
209
220
|
| **Pagination** | `pagination` | Accessible multi-page navigation bar with sliding active page pill, ellipsis jumps, and previous/next page triggers. | `lucide-react`, `motion` | [`components/motion/pagination.tsx`](components/motion/pagination.tsx) | [Guide](references/motion/pagination.md) |
|
|
210
221
|
| **Password Input** | `password-input` | Smart password field with show/hide toggle, animated multi-segment strength meter, and live criteria validation checklist. | `lucide-react`, `motion` | [`components/motion/password-input.tsx`](components/motion/password-input.tsx) | [Guide](references/motion/password-input.md) |
|
|
211
222
|
| **Phone Input** | `phone-input` | International phone number input with search-filtered country selector dropdown, flags, dial codes, and spring transitions. | `lucide-react`, `motion` | [`components/motion/phone-input.tsx`](components/motion/phone-input.tsx) | [Guide](references/motion/phone-input.md) |
|
|
212
223
|
| **Popover** | `popover` | Gooey popover whose panel oozes out of the trigger through an SVG goo filter — a liquid neck that stretches and pinches — with crisp content fading in on top, plus a Morph variant that clip-morphs open from the trigger corner. Click or hover trigger, controlled or uncontrolled. | `lucide-react`, `motion`, `react-dom` | [`components/motion/popover.tsx`](components/motion/popover.tsx) | [Guide](references/motion/popover.md) |
|
|
213
224
|
| **Preview Rail** | `preview-rail` | Codex app-inspired navigation rail with compact ticks that form a hover pyramid and reveal a floating destination preview. | `motion` | [`components/motion/preview-rail.tsx`](components/motion/preview-rail.tsx) | [Guide](references/motion/preview-rail.md) |
|
|
225
|
+
| **Pro Gradient Text** | `pro-gradient-text` | High-performance multi-stop moving gradient typography with configurable angle, speed, chromatic spectrum, and mask clipping. | `motion` | [`components/motion/pro-gradient-text.tsx`](components/motion/pro-gradient-text.tsx) | [Guide](references/motion/pro-gradient-text.md) |
|
|
214
226
|
| **Progress Ring** | `progress-ring` | Circular animated SVG progress gauge with spring stroke dashoffset, customizable gradient stroke, and center label. | `motion` | [`components/motion/progress-ring.tsx`](components/motion/progress-ring.tsx) | [Guide](references/motion/progress-ring.md) |
|
|
215
227
|
| **Pull to Refresh** | `pull-to-refresh` | Native-feeling pull-to-refresh container with drag resistance, threshold feedback and async refresh handling. | `lucide-react`, `motion` | [`components/motion/pull-to-refresh.tsx`](components/motion/pull-to-refresh.tsx) | [Guide](references/motion/pull-to-refresh.md) |
|
|
216
228
|
| **Radio Group** | `radio` | Single-select choice control with a gliding layoutId indicator dot and spring press feedback. | `motion` | [`components/motion/radio.tsx`](components/motion/radio.tsx) | [Guide](references/motion/radio.md) |
|
|
@@ -222,8 +234,11 @@ Ensure your `tailwind.config.js` or `globals.css` supports CSS variable colors (
|
|
|
222
234
|
| **Select** | `select` | Composable select primitives whose panel bouncily unfolds out of the trigger and separates, plus a Morph variant where the trigger grows into the panel via shared layout. | `lucide-react`, `motion` | [`components/motion/select.tsx`](components/motion/select.tsx) | [Guide](references/motion/select.md) |
|
|
223
235
|
| **Shader Background** | `shader-background` | Canvas shader backgrounds (mesh gradient, grain, warp, waves, voronoi, dot orbit and more) with a single typed variant prop. Reduced-motion freezes animated variants. | `@paper-design/shaders-react`, `motion` | [`components/motion/shader-background.tsx`](components/motion/shader-background.tsx) | [Guide](references/motion/shader-background.md) |
|
|
224
236
|
| **Shared Layout Background** | `shared-layout-bg` | A pill that glides between hovered items via motion's shared layout, with blur enter/exit. | `lucide-react`, `motion` | [`components/motion/shared-layout-bg.tsx`](components/motion/shared-layout-bg.tsx) | [Guide](references/motion/shared-layout-bg.md) |
|
|
237
|
+
| **Skeleton Loader and Reveal** | `skeleton-loader-and-reveal` | Adaptive content skeleton with rhythmic shimmer wave that cross-fades directly into live UI surfaces with zero cumulative layout shift. | `motion` | [`components/motion/skeleton-loader-and-reveal.tsx`](components/motion/skeleton-loader-and-reveal.tsx) | [Guide](references/motion/skeleton-loader-and-reveal.md) |
|
|
225
238
|
| **Sortable List** | `sortable-list` | Accessible drag-to-reorder list with drag handle controls, shadow elevation, layout spring realignment, and drop callbacks. | `lucide-react`, `motion` | [`components/motion/sortable-list.tsx`](components/motion/sortable-list.tsx) | [Guide](references/motion/sortable-list.md) |
|
|
226
239
|
| **Speed Dial** | `speed-dial` | Mobile-first floating action button (FAB) that blossoms outwards with staggered action items, 45-degree icon morph, and haptic feedback. | `lucide-react`, `motion` | [`components/motion/speed-dial.tsx`](components/motion/speed-dial.tsx) | [Guide](references/motion/speed-dial.md) |
|
|
240
|
+
| **Spinner to Check Morph** | `spinner-to-check-morph` | Continuous SVG arc loading spinner that morphs smoothly into an animated checkmark path upon async task completion. | `motion` | [`components/motion/spinner-to-check-morph.tsx`](components/motion/spinner-to-check-morph.tsx) | [Guide](references/motion/spinner-to-check-morph.md) |
|
|
241
|
+
| **Spinning Counter** | `spinning-counter` | Mechanical odometer spinning counter dial with velocity spring damping, vertical digit slots, and directional blur. | `motion` | [`components/motion/spinning-counter.tsx`](components/motion/spinning-counter.tsx) | [Guide](references/motion/spinning-counter.md) |
|
|
227
242
|
| **Split Text** | `split-text` | High-performance typography reveal that splits sentences into characters or words with staggered spring entrances. | `motion` | [`components/motion/split-text.tsx`](components/motion/split-text.tsx) | [Guide](references/motion/split-text.md) |
|
|
228
243
|
| **Spotlight Card** | `spotlight-card` | Interactive craft card with mouse-tracking radial spotlight glow, rotating border beam highlight, and subtle depth elevation. | `motion` | [`components/motion/spotlight-card.tsx`](components/motion/spotlight-card.tsx) | [Guide](references/motion/spotlight-card.md) |
|
|
229
244
|
| **Stepper** | `stepper` | Multi-step wizard progress indicator with animated connecting lines, completed checkmarks, and active status indicators. | `lucide-react`, `motion` | [`components/motion/stepper.tsx`](components/motion/stepper.tsx) | [Guide](references/motion/stepper.md) |
|
|
@@ -232,7 +247,9 @@ Ensure your `tailwind.config.js` or `globals.css` supports CSS variable colors (
|
|
|
232
247
|
| **Table** | `table` | Virtualized data table that stays smooth at 10k+ rows, with sortable headers, row selection, column resize and reorder, and a sticky header. Minimal, reduced-motion-safe motion. | `@tanstack/react-virtual`, `lucide-react`, `motion`, `react-dom` | [`components/motion/table/index.tsx`](components/motion/table/index.tsx) | [Guide](references/motion/table.md) |
|
|
233
248
|
| **Tabs** | `tabs` | Pill, segment or underline tabs with a spring layoutId indicator. | `motion` | [`components/motion/tabs.tsx`](components/motion/tabs.tsx) | [Guide](references/motion/tabs.md) |
|
|
234
249
|
| **Text Animation** | `text-animation` | Animated text primitives for spring reveals, chromatic sweeps, shimmer loading states, letter-cascade swaps and character scrambles. | `motion` | [`components/motion/text-reveal.tsx`](components/motion/text-reveal.tsx) | [Guide](references/motion/text-animation.md) |
|
|
250
|
+
| **Text Morph** | `text-morph` | In-place text transition that pins shared character prefixes and suffixes while smoothly cross-blurring and easing changing middle letters. | `motion` | [`components/motion/text-morph.tsx`](components/motion/text-morph.tsx) | [Guide](references/motion/text-morph.md) |
|
|
235
251
|
| **Text Swap** | `text-swap` | Slot-machine vertical ticker transition that rolls text or numbers with subtle blur and spring velocity handoffs. | `motion` | [`components/motion/text-swap.tsx`](components/motion/text-swap.tsx) | [Guide](references/motion/text-swap.md) |
|
|
252
|
+
| **Texts Reveal** | `texts-reveal` | Typographic text reveal container staggering words and lines along spring trajectories with opacity and directional drift. | `motion` | [`components/motion/texts-reveal.tsx`](components/motion/texts-reveal.tsx) | [Guide](references/motion/texts-reveal.md) |
|
|
236
253
|
| **Theme Toggle** | `theme-toggle` | Theme toggle button that repaints the whole page through the View Transition API — a rectangle or circle clip-path reveal, or slats that open across the screen like a shutter. | `lucide-react`, `motion`, `next-themes` | [`components/motion/theme-toggle.tsx`](components/motion/theme-toggle.tsx) | [Guide](references/motion/theme-toggle.md) |
|
|
237
254
|
| **Tilt Card** | `tilt-card` | 3D perspective tilt on hover with cursor-tracked glare. | `motion` | [`components/motion/tilt-card.tsx`](components/motion/tilt-card.tsx) | [Guide](references/motion/tilt-card.md) |
|
|
238
255
|
| **Timeline** | `timeline` | Interactive chronological milestone and audit tracker with animated progress lines, status badges, and expandable step disclosures. | `lucide-react`, `motion` | [`components/motion/timeline.tsx`](components/motion/timeline.tsx) | [Guide](references/motion/timeline.md) |
|
|
@@ -243,7 +260,7 @@ Ensure your `tailwind.config.js` or `globals.css` supports CSS variable colors (
|
|
|
243
260
|
|
|
244
261
|
---
|
|
245
262
|
|
|
246
|
-
### 2. AI Agent Surfaces (
|
|
263
|
+
### 2. AI Agent Surfaces (18)
|
|
247
264
|
|
|
248
265
|
| Component | Slug | Description | Dependencies | Primary File | Docs |
|
|
249
266
|
| :--- | :--- | :--- | :--- | :--- | :--- |
|
|
@@ -261,6 +278,7 @@ Ensure your `tailwind.config.js` or `globals.css` supports CSS variable colors (
|
|
|
261
278
|
| **Message Scroller** | `message-scroller` | A reader-aware conversation viewport that follows streamed output at the live edge and releases control when the reader moves away. | `lucide-react`, `motion`, `react-dom` | [`components/agents/message-scroller.tsx`](components/agents/message-scroller.tsx) | [Guide](references/agents/message-scroller.md) |
|
|
262
279
|
| **Prompt Input** | `prompt-input` | An auto-growing agent composer with prompt actions, model selection, keyboard submission, and animated send and stop states. | `lucide-react`, `motion`, `react-dom` | [`components/agents/prompt-input.tsx`](components/agents/prompt-input.tsx) | [Guide](references/agents/prompt-input.md) |
|
|
263
280
|
| **Streaming Response** | `streaming-response` | A stable response surface with completion actions, rendered content, and an expandable source summary. | `lucide-react`, `motion` | [`components/agents/streaming-response.tsx`](components/agents/streaming-response.tsx) | [Guide](references/agents/streaming-response.md) |
|
|
281
|
+
| **Thinking States** | `thinking-states` | Conversational AI agent thinking bubble morphing through cognitive stages (evaluating, searching, reasoning, finalizing) with organic pulse dots. | `motion` | [`components/agents/thinking-states.tsx`](components/agents/thinking-states.tsx) | [Guide](references/agents/thinking-states.md) |
|
|
264
282
|
| **Todo List** | `todo-list` | A collapsible agent task plan with morphing status marks, a completion count, compact metadata, and smooth list updates. | `lucide-react`, `motion` | [`components/agents/todo-list.tsx`](components/agents/todo-list.tsx) | [Guide](references/agents/todo-list.md) |
|
|
265
283
|
| **Tool Approval** | `tool-approval` | A human-in-the-loop permission card for reviewing tool details, allowing once, remembering access, or denying execution. | `lucide-react`, `motion`, `shiki` | [`components/agents/tool-approval.tsx`](components/agents/tool-approval.tsx) | [Guide](references/agents/tool-approval.md) |
|
|
266
284
|
| **Tool Result** | `tool-result` | A lightweight execution disclosure for syntax-highlighted terminal output and request responses that collapses into a compact completed state. | `lucide-react`, `motion`, `shiki` | [`components/agents/tool-result.tsx`](components/agents/tool-result.tsx) | [Guide](references/agents/tool-result.md) |
|
|
@@ -307,7 +325,7 @@ Ensure your `tailwind.config.js` or `globals.css` supports CSS variable colors (
|
|
|
307
325
|
|
|
308
326
|
---
|
|
309
327
|
|
|
310
|
-
### 4. Craft & Surface Components (
|
|
328
|
+
### 4. Craft & Surface Components (236)
|
|
311
329
|
|
|
312
330
|
| Component | Slug | Description | Dependencies | Primary File | Docs |
|
|
313
331
|
| :--- | :--- | :--- | :--- | :--- | :--- |
|
|
@@ -325,7 +343,9 @@ Ensure your `tailwind.config.js` or `globals.css` supports CSS variable colors (
|
|
|
325
343
|
| **Apple Macbook** | `laptop` | Apple Macbook component. | None (core) | [`components/mockups/laptop-mockup-card.tsx`](components/mockups/laptop-mockup-card.tsx) | [Guide](references/craft/laptop.md) |
|
|
326
344
|
| **Apple Notification** | `apple-notification` | Frosted iOS notification with app name, sender, message, and avatar — dismisses with animation and can be triggered again via button. | `lucide-react`, `next` | [`components/notifications/apple-notification-banner.tsx`](components/notifications/apple-notification-banner.tsx) | [Guide](references/craft/apple-notification.md) |
|
|
327
345
|
| **Apple Watch** | `apple-watch` | Apple Watch frame with sport band and a rounded display slot for your UI. Pass variant for black, silver, titanium, starlight, blue, gold, or rose finishes. | None (core) | [`components/mockups/apple-watch-mockup-card.tsx`](components/mockups/apple-watch-mockup-card.tsx) | [Guide](references/craft/apple-watch.md) |
|
|
346
|
+
| **Aqua Button** | `aqua-button` | Glossy pill button inspired by Apple classic Aqua interface, with layered highlights and soft inner glow. | None (core) | [`components/buttons/aqua-button.tsx`](components/buttons/aqua-button.tsx) | [Guide](references/craft/aqua-button.md) |
|
|
328
347
|
| **Arc Bands** | `arc-bands-background` | Retro poster arcs with sky, teal, amber, and rose blending in soft radial gradients from the base — festivals, launches, and playful brand moments. | None (core) | [`components/background-gradient/arc-bands-background.tsx`](components/background-gradient/arc-bands-background.tsx) | [Guide](references/craft/arc-bands-background.md) |
|
|
348
|
+
| **Ash Burst Button** | `ash-burst-button` | Ringed dark button that glows like an ember on click and erupts realistic ash particles using Matter.js physics. | `matter-js`, `react-dom` | [`components/buttons/ash-burst-button.tsx`](components/buttons/ash-burst-button.tsx) | [Guide](references/craft/ash-burst-button.md) |
|
|
329
349
|
| **Audio Recorder** | `audio-recorder` | Dark recording card with title, date, animated red waveform, and elapsed time. Play and pause feel like a native voice memo app. | `lucide-react` | [`components/widgets/audio-recorder-widget.tsx`](components/widgets/audio-recorder-widget.tsx) | [Guide](references/craft/audio-recorder.md) |
|
|
330
350
|
| **Aurora Background** | `aurora-background` | Soft aurora wash with lime, mint, cyan, and blue blobs over a warm paper base — wrap any page section or hero and pass children on top. | None (core) | [`components/background-gradient/aurora-background.tsx`](components/background-gradient/aurora-background.tsx) | [Guide](references/craft/aurora-background.md) |
|
|
331
351
|
| **Battery Face** | `battery-face` | Battery level as a character — arc ring, percentage, hours left, and a face that actually looks sad when you're running low. | `lucide-react` | [`components/widgets/battery-face-widget.tsx`](components/widgets/battery-face-widget.tsx) | [Guide](references/craft/battery-face.md) |
|
|
@@ -333,18 +353,24 @@ Ensure your `tailwind.config.js` or `globals.css` supports CSS variable colors (
|
|
|
333
353
|
| **Bluetooth Face** | `bluetooth-face` | A teal mascot face that reacts when Bluetooth connects or drops. Toggle on/off with an expression change — playful, but still reads as a real status widget. | `lucide-react` | [`components/widgets/bluetooth-face-widget.tsx`](components/widgets/bluetooth-face-widget.tsx) | [Guide](references/craft/bluetooth-face.md) |
|
|
334
354
|
| **Booking Slot Calendar** | `booking-slot-calendar` | Appointment booking flow — week strip on top, time slots below. Unavailable slots are crossed out, tap to book. | `lucide-react` | [`components/calendar/booking-slot-calendar.tsx`](components/calendar/booking-slot-calendar.tsx) | [Guide](references/craft/booking-slot-calendar.md) |
|
|
335
355
|
| **Bookmark Save** | `bookmark-save-button` | Save for later — bookmark icon fills amber and label swaps to Saved. Square-ish control for articles and products. | `lucide-react` | [`components/buttons/bookmark-save-button.tsx`](components/buttons/bookmark-save-button.tsx) | [Guide](references/craft/bookmark-save-button.md) |
|
|
356
|
+
| **Brutal Button** | `brutal-button` | Neo-brutalism button with stark borders, solid drop shadows, and high-contrast tactile depression. | None (core) | [`components/buttons/brutal-button.tsx`](components/buttons/brutal-button.tsx) | [Guide](references/craft/brutal-button.md) |
|
|
336
357
|
| **Cafe Menu Board** | `cafe-menu-board` | Dark chalkboard-style menu with cafe header, item notes, and amber price accents — hospitality and local brand sites. | `lucide-react` | [`components/text/cafe-menu-board-card.tsx`](components/text/cafe-menu-board-card.tsx) | [Guide](references/craft/cafe-menu-board.md) |
|
|
337
358
|
| **Calendar Reminder Notification** | `calendar-reminder-notification` | Calendar reminder on the iOS grid — red app tile, event name, and time until it starts. | `lucide-react` | [`components/notifications/calendar-reminder-notification-banner.tsx`](components/notifications/calendar-reminder-notification-banner.tsx) | [Guide](references/craft/calendar-reminder-notification.md) |
|
|
338
359
|
| **Chat Bubble Notification** | `chat-bubble-notification` | Messenger-style bubble — small avatar, sender name, rounded message bubble with a flat tail corner. | `lucide-react`, `next` | [`components/notifications/chat-bubble-notification-banner.tsx`](components/notifications/chat-bubble-notification-banner.tsx) | [Guide](references/craft/chat-bubble-notification.md) |
|
|
339
360
|
| **Checkbox Field Input** | `checkbox-field-input` | Accessible checkbox with custom mark, inline label, hint, and error. Controlled or uncontrolled checked state. | `lucide-react` | [`components/inputs/checkbox-field-input.tsx`](components/inputs/checkbox-field-input.tsx) | [Guide](references/craft/checkbox-field-input.md) |
|
|
340
361
|
| **Cherry Petal** | `cherry-petal-background` | Soft spring canvas with drifting cherry petals and a blush radial glow — weddings, florists, and seasonal campaigns. | None (core) | [`components/background-gradient/cherry-petal-background.tsx`](components/background-gradient/cherry-petal-background.tsx) | [Guide](references/craft/cherry-petal-background.md) |
|
|
362
|
+
| **Chrome Button** | `chrome-button` | Metallic pill button whose border is a ring of flowing liquid chrome reflection around a solid face. | None (core) | [`components/buttons/chrome-button.tsx`](components/buttons/chrome-button.tsx) | [Guide](references/craft/chrome-button.md) |
|
|
341
363
|
| **Cinder Latch** | `cinder-latch-button` | Charcoal latch button with a warm ember under-glow, center groove, and face sheen — built for secure-action CTAs. | None (core) | [`components/buttons/cinder-latch-button.tsx`](components/buttons/cinder-latch-button.tsx) | [Guide](references/craft/cinder-latch-button.md) |
|
|
342
364
|
| **Cinema Ticket** | `cinema-ticket` | Split cinema ticket with film title, venue, screen, seats, show time, and a perforated stub. Dark ticket stock that feels printed, not flat. | `lucide-react` | [`components/text/cinema-ticket-card.tsx`](components/text/cinema-ticket-card.tsx) | [Guide](references/craft/cinema-ticket.md) |
|
|
343
365
|
| **Circle Cut Frame** | `circle-cut-frame` | Ticket-style frame with circle-cut edges on all sides — defaults to white; pass width, height, frameColor, and any image, video, or content as children. | None (core) | [`components/frames/circle-cut-frame.tsx`](components/frames/circle-cut-frame.tsx) | [Guide](references/craft/circle-cut-frame.md) |
|
|
366
|
+
| **Click Power-Up** | `click-powerup` | Bracketed button that arms on hover and powers up with an accent flash and bracket burst on every click. | `motion` | [`components/buttons/click-powerup.tsx`](components/buttons/click-powerup.tsx) | [Guide](references/craft/click-powerup.md) |
|
|
344
367
|
| **Combobox Field Input** | `combobox-field-input` | Searchable combobox with filtered listbox, keyboard navigation, click-outside close, and hidden field for form posts. | `lucide-react` | [`components/inputs/combobox-field-input.tsx`](components/inputs/combobox-field-input.tsx) | [Guide](references/craft/combobox-field-input.md) |
|
|
368
|
+
| **Command Button** | `command-button` | Interactive command button with live shortcut key badge and mechanical key switch feedback. | None (core) | [`components/buttons/command-button.tsx`](components/buttons/command-button.tsx) | [Guide](references/craft/command-button.md) |
|
|
345
369
|
| **Compass** | `compass` | A compass dial with labeled directions and a needle that follows device tilt. Pass a heading prop or let the browser handle orientation. | None (core) | [`components/widgets/compass-widget.tsx`](components/widgets/compass-widget.tsx) | [Guide](references/craft/compass.md) |
|
|
370
|
+
| **Confetti Button** | `confetti-button` | Ringed dark button that triggers a celebratory canvas confetti burst with radial particle trajectories. | `canvas-confetti` | [`components/buttons/confetti-button.tsx`](components/buttons/confetti-button.tsx) | [Guide](references/craft/confetti-button.md) |
|
|
346
371
|
| **Contact Form** | `contact-form` | Contact form with honeypot spam guard, character count, field validation, loading state, and success confirmation screen. | `lucide-react` | [`components/forms/contact-form.tsx`](components/forms/contact-form.tsx) | [Guide](references/craft/contact-form.md) |
|
|
347
372
|
| **Contact Profile** | `contact-profile` | Museum placard contact directory — mono labels, serif name, and typographic rows without icon clutter. | `next` | [`components/profile/contact-profile-card.tsx`](components/profile/contact-profile-card.tsx) | [Guide](references/craft/contact-profile.md) |
|
|
373
|
+
| **Cooldown Button** | `cooldown-button` | Button that locks itself behind a draining radial timer after each click to prevent spam and double submits. | `motion` | [`components/buttons/cooldown-button.tsx`](components/buttons/cooldown-button.tsx) | [Guide](references/craft/cooldown-button.md) |
|
|
348
374
|
| **Copy Email Button** | `copy-email` | One-click copy maintainer email address with inline tooltip feedback ("Click to copy" / "Copied") and zero mailbox popup. | None (core) | [`components/contact/copy-email.tsx`](components/contact/copy-email.tsx) | [Guide](references/craft/copy-email.md) |
|
|
349
375
|
| **Coral Glow** | `coral-glow-background` | Warm aurora wash in rose, peach, coral, and gold over a blush paper base — beauty, lifestyle, and invitation hero sections. | None (core) | [`components/background-gradient/coral-glow-background.tsx`](components/background-gradient/coral-glow-background.tsx) | [Guide](references/craft/coral-glow-background.md) |
|
|
350
376
|
| **Craft Signup Form** | `craft-signup-form` | Registration form with name, email, password strength rules, confirm password match, and required terms acceptance. | `lucide-react`, `next` | [`components/forms/signup-form.tsx`](components/forms/signup-form.tsx) | [Guide](references/craft/craft-signup-form.md) |
|
|
@@ -363,14 +389,17 @@ Ensure your `tailwind.config.js` or `globals.css` supports CSS variable colors (
|
|
|
363
389
|
| **Date Field Input** | `date-field-input` | Custom calendar popover with month navigation, today shortcut, min/max limits, and styled day grid — no native browser picker. | `lucide-react` | [`components/inputs/date-field-input.tsx`](components/inputs/date-field-input.tsx) | [Guide](references/craft/date-field-input.md) |
|
|
364
390
|
| **Date Range Picker Card** | `date-range-picker-card` | Travel-style date range picker — first tap sets check-in, second sets check-out, days between fill in. | `lucide-react` | [`components/calendar/date-range-picker-card.tsx`](components/calendar/date-range-picker-card.tsx) | [Guide](references/craft/date-range-picker-card.md) |
|
|
365
391
|
| **Delivery Notification** | `delivery-notification` | Shipping update — package icon, delivery status, ETA, and order number in a compact row. | `lucide-react` | [`components/notifications/delivery-notification-banner.tsx`](components/notifications/delivery-notification-banner.tsx) | [Guide](references/craft/delivery-notification.md) |
|
|
392
|
+
| **Demonic Button** | `demonic-button` | Hold-to-summon button that raises devil horns from behind while an interactive canvas fire builds into a roar. | None (core) | [`components/buttons/demonic-button.tsx`](components/buttons/demonic-button.tsx) | [Guide](references/craft/demonic-button.md) |
|
|
366
393
|
| **Denim Product Editorial** | `denim-product-editorial` | Fashion editorial with two square photos, rotated callout labels, and uppercase product description. Lookbook energy for apparel and accessories. | `next` | [`components/text/denim-product-editorial-card.tsx`](components/text/denim-product-editorial-card.tsx) | [Guide](references/craft/denim-product-editorial.md) |
|
|
367
394
|
| **Deploy Notification** | `deploy-notification` | Deploy alert on the iOS grid — Vercel triangle tile, short status line with project, branch, and duration. | `lucide-react` | [`components/notifications/deploy-notification-banner.tsx`](components/notifications/deploy-notification-banner.tsx) | [Guide](references/craft/deploy-notification.md) |
|
|
368
395
|
| **Depth Outline** | `depth-outline-button` | Premium outline button with layered float depth, a soft top lip, and a press-in sink — secondary CTA that still feels tactile. Pass any children. | None (core) | [`components/buttons/depth-outline-button.tsx`](components/buttons/depth-outline-button.tsx) | [Guide](references/craft/depth-outline-button.md) |
|
|
369
396
|
| **Diagonal Box** | `diagonal-box-pattern` | Classic 45° hairline hatch on white — the same quiet stage used across marketing mockups and component previews. | None (core) | [`components/background-pattern/diagonal-box-pattern.tsx`](components/background-pattern/diagonal-box-pattern.tsx) | [Guide](references/craft/diagonal-box-pattern.md) |
|
|
370
397
|
| **Dimple Switch** | `dimple-switch` | Tactile switch with a dimpled knob, metallic track, and amber on-state fill. Hidden checkbox drives the slide — controlled or uncontrolled. | None (core) | [`components/buttons/dimple-switch.tsx`](components/buttons/dimple-switch.tsx) | [Guide](references/craft/dimple-switch.md) |
|
|
371
398
|
| **Discord Chat** | `discord-chat` | Dark Discord channel with server header, threaded messages, avatars, timestamps, and a send input. Community product mockups in one card. | `lucide-react`, `next` | [`components/socials/discord-chat-card.tsx`](components/socials/discord-chat-card.tsx) | [Guide](references/craft/discord-chat.md) |
|
|
399
|
+
| **Dither Button** | `dither-button` | High-contrast button with an animated 4x4 ordered-dither wave background and knockout typography. | None (core) | [`components/buttons/dither-button.tsx`](components/buttons/dither-button.tsx) | [Guide](references/craft/dither-button.md) |
|
|
372
400
|
| **Dnd Face** | `dnd-face` | Focus mode as a purple moon mascot — tap to toggle DND and watch the expression shift. Makes a utilitarian setting feel a little human. | `lucide-react` | [`components/widgets/dnd-face-widget.tsx`](components/widgets/dnd-face-widget.tsx) | [Guide](references/craft/dnd-face.md) |
|
|
373
401
|
| **Dot Grid** | `dot-grid-pattern` | Soft dotted grid on neutral paper — watch mockup stages, device demos, and minimal product sections. | None (core) | [`components/background-pattern/dot-grid-pattern.tsx`](components/background-pattern/dot-grid-pattern.tsx) | [Guide](references/craft/dot-grid-pattern.md) |
|
|
402
|
+
| **Doubt Button** | `doubt-button` | Escalating-confirmation button that prompts the user through comical guilt-tripping steps before firing. | `motion` | [`components/buttons/doubt-button.tsx`](components/buttons/doubt-button.tsx) | [Guide](references/craft/doubt-button.md) |
|
|
374
403
|
| **Download with States** | `download-button` | Raised 3D download key that sinks while downloading — arrow morphs to spinner to check — then pops back up as a solid emerald done state. | `lucide-react` | [`components/buttons/download-button.tsx`](components/buttons/download-button.tsx) | [Guide](references/craft/download-button.md) |
|
|
375
404
|
| **Drop Cap Editorial** | `drop-cap-editorial` | Editorial quote block with a large drop-cap letter, body text, and author attribution. Magazine typography without opening InDesign. | `lucide-react` | [`components/text/drop-cap-editorial-card.tsx`](components/text/drop-cap-editorial-card.tsx) | [Guide](references/craft/drop-cap-editorial.md) |
|
|
376
405
|
| **Editor Tool Dock** | `editor-tool-dock` | Vertical editor tool dock using MacDock tile size, padding, and ease-smooth hover scale. | `lucide-react` | [`components/docks/editor-tool-dock.tsx`](components/docks/editor-tool-dock.tsx) | [Guide](references/craft/editor-tool-dock.md) |
|
|
@@ -380,6 +409,7 @@ Ensure your `tailwind.config.js` or `globals.css` supports CSS variable colors (
|
|
|
380
409
|
| **Email Notification** | `email-notification` | Mail alert on the iOS grid — sender avatar, app name header, natural from: subject — preview body line. | `lucide-react`, `next` | [`components/notifications/email-notification-banner.tsx`](components/notifications/email-notification-banner.tsx) | [Guide](references/craft/email-notification.md) |
|
|
381
410
|
| **Event Countdown Card** | `event-countdown-card` | Live countdown to an event — days, hours, and minutes update every minute. Editorial typography, no ticker gimmicks. | None (core) | [`components/calendar/event-countdown-card.tsx`](components/calendar/event-countdown-card.tsx) | [Guide](references/craft/event-countdown-card.md) |
|
|
382
411
|
| **Event Ticket** | `event-ticket` | Perforated event ticket with a cover-image date block and VIP pass details on the right. Concert, conference, or launch night — same component. | `lucide-react`, `next` | [`components/event/event-ticket-card.tsx`](components/event/event-ticket-card.tsx) | [Guide](references/craft/event-ticket.md) |
|
|
412
|
+
| **Evil Eye Button** | `evil-eye-button` | Obsidian pill button with a burning eye behind the label that tracks cursor movement across the viewport. | None (core) | [`components/buttons/evil-eye-button.tsx`](components/buttons/evil-eye-button.tsx) | [Guide](references/craft/evil-eye-button.md) |
|
|
383
413
|
| **Facebook Post** | `facebook-post` | Facebook feed post with reactions, comments, share counts, optional image, and the full action bar. Familiar layout, your content. | `lucide-react`, `next` | [`components/socials/facebook-post-card.tsx`](components/socials/facebook-post-card.tsx) | [Guide](references/craft/facebook-post.md) |
|
|
384
414
|
| **File Menu** | `file-menu` | Folder icon you can right-click or tap to open a centered action menu — edit, duplicate, pin, move, delete. Keyboard-friendly item hints included. | `lucide-react` | [`components/dropdowns/file-menu-dropdown.tsx`](components/dropdowns/file-menu-dropdown.tsx) | [Guide](references/craft/file-menu.md) |
|
|
385
415
|
| **File Upload Field Input** | `file-upload-field-input` | Card-style file upload with drag-and-drop zone, browse button, format/size hints, typed file rows, and remove actions. | `lucide-react` | [`components/inputs/file-upload-field-input.tsx`](components/inputs/file-upload-field-input.tsx) | [Guide](references/craft/file-upload-field-input.md) |
|
|
@@ -394,16 +424,20 @@ Ensure your `tailwind.config.js` or `globals.css` supports CSS variable colors (
|
|
|
394
424
|
| **Folder Tab Card** | `folder-tab-card` | Folder tab card with black frame, top-half image, and dark panel showing library stats. Studio App branding by default. | `next` | [`components/folder/folder-tab-card.tsx`](components/folder/folder-tab-card.tsx) | [Guide](references/craft/folder-tab-card.md) |
|
|
395
425
|
| **Follow Toggle** | `follow-button` | Social follow toggle — dark Follow pill becomes a quiet Following state with a user-check icon. Tap again to unfollow. | `lucide-react` | [`components/buttons/follow-button.tsx`](components/buttons/follow-button.tsx) | [Guide](references/craft/follow-button.md) |
|
|
396
426
|
| **Forgot Password Form** | `forgot-password-form` | Password reset request form with email validation, loading state, success screen, and back-to-login navigation. | `lucide-react`, `next` | [`components/forms/forgot-password-form.tsx`](components/forms/forgot-password-form.tsx) | [Guide](references/craft/forgot-password-form.md) |
|
|
427
|
+
| **Frame Button** | `frame-button` | Technical framed button with reticle crosshair corners, bracket accents, and ambient corner blooming on hover. | `motion` | [`components/buttons/frame-button.tsx`](components/buttons/frame-button.tsx) | [Guide](references/craft/frame-button.md) |
|
|
397
428
|
| **Frost Mesh** | `frost-mesh-background` | Cool frost-white mesh with teal and emerald corner washes — SaaS dashboards, health apps, and minimal product launches. | None (core) | [`components/background-gradient/frost-mesh-background.tsx`](components/background-gradient/frost-mesh-background.tsx) | [Guide](references/craft/frost-mesh-background.md) |
|
|
398
429
|
| **Gallery Grid** | `gallery-grid` | Album preview with title, subtitle, and a three-cell photo grid — last cell shows a +N overflow count. Portfolio and gallery index pages. | `lucide-react`, `next` | [`components/gallery/gallery-grid-card.tsx`](components/gallery/gallery-grid-card.tsx) | [Guide](references/craft/gallery-grid.md) |
|
|
399
430
|
| **Gallery Wall** | `gallery-wall` | Gallery wall mat with cream matting, artwork preview, and caption block — clean exhibition styling. | `next` | [`components/gallery/gallery-wall-card.tsx`](components/gallery/gallery-wall-card.tsx) | [Guide](references/craft/gallery-wall.md) |
|
|
400
431
|
| **Github Contribution** | `github-contribution` | GitHub-style contribution heatmap with year selector, total count, and Less/More legend. Pulls real data when you pass a username. | `lucide-react` | [`components/socials/github-contribution.tsx`](components/socials/github-contribution.tsx) | [Guide](references/craft/github-contribution.md) |
|
|
401
432
|
| **Github Repo** | `github-repo` | GitHub repo card with owner, description, language dot, star/fork counts, and a toggleable Star button. Open source landing pages, simplified. | `lucide-react` | [`components/socials/github-repo-card.tsx`](components/socials/github-repo-card.tsx) | [Guide](references/craft/github-repo.md) |
|
|
402
433
|
| **Glass Overlay Image** | `glass-overlay-image` | Full-bleed photo with frosted bottom panel — location, title, saved avatars, and Explore CTA. Like and share buttons float top-right. | `lucide-react`, `next` | [`components/gallery/glass-overlay-image-card.tsx`](components/gallery/glass-overlay-image-card.tsx) | [Guide](references/craft/glass-overlay-image.md) |
|
|
434
|
+
| **Glitch Button** | `glitch-button` | Cyberpunk button with chromatic aberration RGB splitting, scanline jitter, and glitch slices on hover. | None (core) | [`components/buttons/glitch-button.tsx`](components/buttons/glitch-button.tsx) | [Guide](references/craft/glitch-button.md) |
|
|
403
435
|
| **Graph Paper** | `graph-paper-pattern` | Clean square grid for sketches, wireframes, and planning boards — subtle ink lines on white. | None (core) | [`components/background-pattern/graph-paper-pattern.tsx`](components/background-pattern/graph-paper-pattern.tsx) | [Guide](references/craft/graph-paper-pattern.md) |
|
|
404
436
|
| **Halftone Pop** | `halftone-pop-background` | Risograph-style halftone dots in rose, teal, and amber on cream — posters, zines, and bold creative brands. | None (core) | [`components/background-gradient/halftone-pop-background.tsx`](components/background-gradient/halftone-pop-background.tsx) | [Guide](references/craft/halftone-pop-background.md) |
|
|
405
437
|
| **Hard Shadow Polaroid Frame** | `hard-shadow-polaroid-frame` | Polaroid frame with a crisp inner border, thick caption chin, and hard offset shadow — pass caption and any image or video as children. | None (core) | [`components/frames/hard-shadow-polaroid-frame.tsx`](components/frames/hard-shadow-polaroid-frame.tsx) | [Guide](references/craft/hard-shadow-polaroid-frame.md) |
|
|
406
438
|
| **Heart Rate** | `heart-rate` | Heart rate in the DND face layout — mascot at the bottom, BPM above the dial, soft pulse on the ring. | `lucide-react` | [`components/widgets/heart-rate-widget.tsx`](components/widgets/heart-rate-widget.tsx) | [Guide](references/craft/heart-rate.md) |
|
|
439
|
+
| **Highlight Button** | `highlight-button` | Button with an ambient continuous border highlight tracing its perimeter smoothly on hover. | `motion` | [`components/buttons/highlight-button.tsx`](components/buttons/highlight-button.tsx) | [Guide](references/craft/highlight-button.md) |
|
|
440
|
+
| **Hold Button** | `hold-button` | Hold-to-confirm button whose inner fill grows smoothly from 0 to 100% with shake-to-abort feedback. | None (core) | [`components/buttons/hold-button.tsx`](components/buttons/hold-button.tsx) | [Guide](references/craft/hold-button.md) |
|
|
407
441
|
| **Hold to Delete** | `hold-to-delete-button` | Press and hold as a fill sweeps across; release early to cancel, hold to the end to delete. Prevents accidental destructive taps. | `lucide-react` | [`components/buttons/hold-to-delete-button.tsx`](components/buttons/hold-to-delete-button.tsx) | [Guide](references/craft/hold-to-delete-button.md) |
|
|
408
442
|
| **Home** | `mac-dock` | Frosted macOS-style app dock with smooth hover lift, tooltips, and brand icons — Tailwind-only, no motion library. | `next` | [`components/docks/mac-dock.tsx`](components/docks/mac-dock.tsx) | [Guide](references/craft/mac-dock.md) |
|
|
409
443
|
| **Honey Ember** | `honey-ember-background` | Cozy aurora glow in honey, amber, ember orange, and soft rose over warm ivory — food, bakery, and autumn campaigns. | None (core) | [`components/background-gradient/honey-ember-background.tsx`](components/background-gradient/honey-ember-background.tsx) | [Guide](references/craft/honey-ember-background.md) |
|
|
@@ -428,9 +462,13 @@ Ensure your `tailwind.config.js` or `globals.css` supports CSS variable colors (
|
|
|
428
462
|
| **Linked In Profile** | `linked-in-profile` | LinkedIn profile card with cover photo, avatar, headline, stats, bio, and Connect/Message buttons. Professional social, component-sized. | `next` | [`components/socials/linked-in-profile-card.tsx`](components/socials/linked-in-profile-card.tsx) | [Guide](references/craft/linked-in-profile.md) |
|
|
429
463
|
| **Login Form** | `login-form` | Production login form with email/password validation, remember me, show password, loading state, and forgot-password link. | `lucide-react`, `next` | [`components/forms/login-form.tsx`](components/forms/login-form.tsx) | [Guide](references/craft/login-form.md) |
|
|
430
464
|
| **Magazine Cover** | `magazine-cover` | Tall magazine cover with issue badge, category, title, author, and read time. Hover zoom on the cover image — editorial hero material. | `lucide-react`, `next` | [`components/text/magazine-cover-card.tsx`](components/text/magazine-cover-card.tsx) | [Guide](references/craft/magazine-cover.md) |
|
|
465
|
+
| **Minecraft Button** | `minecraft-button` | Pixel stone menu button that cracks upon repeated clicks, shatters into chips, and drops an item to respawn. | `react-dom` | [`components/buttons/minecraft-button.tsx`](components/buttons/minecraft-button.tsx) | [Guide](references/craft/minecraft-button.md) |
|
|
431
466
|
| **Minimal Agenda** | `minimal-agenda` | Today's tasks with times — tap a row to mark it done with a strikethrough and checkmark. Clean enough for a daily planner sidebar. | `lucide-react` | [`components/widgets/minimal-agenda-widget.tsx`](components/widgets/minimal-agenda-widget.tsx) | [Guide](references/craft/minimal-agenda.md) |
|
|
467
|
+
| **Minimal Button** | `minimal-button` | Quiet dark button with hairline ring, inner specular highlight, soft shadow, and subtle chevron hover nudge. | None (core) | [`components/buttons/minimal-button.tsx`](components/buttons/minimal-button.tsx) | [Guide](references/craft/minimal-button.md) |
|
|
432
468
|
| **Mint Lagoon** | `mint-lagoon-background` | Cool aurora wash in emerald, teal, cyan, and mint over a fresh white base — wellness, spa, and clean product launches. | None (core) | [`components/background-gradient/mint-lagoon-background.tsx`](components/background-gradient/mint-lagoon-background.tsx) | [Guide](references/craft/mint-lagoon-background.md) |
|
|
433
469
|
| **Month Picker Calendar** | `month-picker-calendar` | Full month picker with prev/next navigation — tap any day to select it, today gets a quiet ring. | `lucide-react` | [`components/calendar/month-picker-calendar.tsx`](components/calendar/month-picker-calendar.tsx) | [Guide](references/craft/month-picker-calendar.md) |
|
|
470
|
+
| **Morph Status Button** | `morph-status-button` | Button that morphs through idle, loading, success, and error states seamlessly in place with zero layout shift. | `motion` | [`components/buttons/morph-status-button.tsx`](components/buttons/morph-status-button.tsx) | [Guide](references/craft/morph-status-button.md) |
|
|
471
|
+
| **Movie Pass Button** | `movie-pass-button` | Cinema pass button that tears cleanly along perforated stub notches upon click with hinge physics. | `motion` | [`components/buttons/movie-pass-button.tsx`](components/buttons/movie-pass-button.tsx) | [Guide](references/craft/movie-pass-button.md) |
|
|
434
472
|
| **Museum Placard** | `museum-placard` | Gallery exhibition label that flips to reveal curator notes and acquisition details. Art portfolios and culture sites love this interaction. | None (core) | [`components/gallery/museum-placard-card.tsx`](components/gallery/museum-placard-card.tsx) | [Guide](references/craft/museum-placard.md) |
|
|
435
473
|
| **Music Player** | `music-player` | Full dark player card with cover art, album info, progress scrubber with times, and transport controls. Not a bar — the whole now-playing screen. | `lucide-react`, `next` | [`components/audio/music-player-card.tsx`](components/audio/music-player-card.tsx) | [Guide](references/craft/music-player.md) |
|
|
436
474
|
| **Music Playlist** | `music-playlist` | Playlist card with cover, header stats, and a track list where each row toggles play independently. One component, full playlist UI. | `lucide-react`, `next` | [`components/audio/music-playlist-card.tsx`](components/audio/music-playlist-card.tsx) | [Guide](references/craft/music-playlist.md) |
|
|
@@ -457,11 +495,13 @@ Ensure your `tailwind.config.js` or `globals.css` supports CSS variable colors (
|
|
|
457
495
|
| **Quantity Stepper** | `quantity-stepper-button` | Inline minus / count / plus control for carts and forms. Clamps between min and max, disables at the edges. | `lucide-react` | [`components/buttons/quantity-stepper-button.tsx`](components/buttons/quantity-stepper-button.tsx) | [Guide](references/craft/quantity-stepper-button.md) |
|
|
458
496
|
| **Radio Group Field Input** | `radio-group-field-input` | Card-style radio group for checkout and settings flows. Vertical or horizontal layout, descriptions, and arrow-key navigation. | None (core) | [`components/inputs/radio-group-field-input.tsx`](components/inputs/radio-group-field-input.tsx) | [Guide](references/craft/radio-group-field-input.md) |
|
|
459
497
|
| **Rain Prism** | `rain-prism-background` | Moody rainfall with angled streaks and a soft prism band across the scene — music, film, and reflective editorial layouts. | None (core) | [`components/background-gradient/rain-prism-background.tsx`](components/background-gradient/rain-prism-background.tsx) | [Guide](references/craft/rain-prism-background.md) |
|
|
498
|
+
| **Realistic Switch** | `realistic-switch` | Latching physical push switch that sinks into a recessed socket, stays down with an internal glow, and pops up. | `motion` | [`components/buttons/realistic-switch.tsx`](components/buttons/realistic-switch.tsx) | [Guide](references/craft/realistic-switch.md) |
|
|
460
499
|
| **Recent Transactions Table** | `recent-transactions-table` | Stripe-style transaction list with positive and negative amounts and simple pagination. | `lucide-react` | [`components/table/recent-transactions-table.tsx`](components/table/recent-transactions-table.tsx) | [Guide](references/craft/recent-transactions-table.md) |
|
|
461
500
|
| **Recessed Inset** | `inset-button` | Recessed inset button — looks pressed into the surface. Light or dark variant. Pass any children. | None (core) | [`components/buttons/inset-button.tsx`](components/buttons/inset-button.tsx) | [Guide](references/craft/inset-button.md) |
|
|
462
501
|
| **Recorder Face** | `recorder-face` | A quirky record button with a mascot face, circular dial, and live timer. Tap to start and pause — feels like a tiny dedicated recorder app. | `lucide-react` | [`components/widgets/recorder-face-widget.tsx`](components/widgets/recorder-face-widget.tsx) | [Guide](references/craft/recorder-face.md) |
|
|
463
502
|
| **Resource Links Panel** | `resource-links-panel` | Resource link list with logo, name, description, and domain per row — same layout as the homepage Resources section. Copy and pass title + items. | `next` | [`components/resources/resource-links-panel.tsx`](components/resources/resource-links-panel.tsx) | [Guide](references/craft/resource-links-panel.md) |
|
|
464
503
|
| **Retail Price Tag** | `retail-price-tag` | Hanging store tag with discount badge, sale price, SKU, and barcode stripes. E-commerce editorial and product drops. | None (core) | [`components/pricing/retail-price-tag-card.tsx`](components/pricing/retail-price-tag-card.tsx) | [Guide](references/craft/retail-price-tag.md) |
|
|
504
|
+
| **Reveal Button** | `reveal-button` | Button that conceals and reveals a sensitive secret value on hold or toggle with blur-in transitions. | `motion` | [`components/buttons/reveal-button.tsx`](components/buttons/reveal-button.tsx) | [Guide](references/craft/reveal-button.md) |
|
|
465
505
|
| **Reverse Diagonal Box** | `reverse-diagonal-box-pattern` | Mirrored 45° hairline hatch — same quiet stage as Diagonal Box, rotated right to left for visual variety. | None (core) | [`components/background-pattern/reverse-diagonal-box-pattern.tsx`](components/background-pattern/reverse-diagonal-box-pattern.tsx) | [Guide](references/craft/reverse-diagonal-box-pattern.md) |
|
|
466
506
|
| **Ride Pickup** | `ride-pickup` | Uber-style pickup card with brand, ETA, car illustration, and vehicle ID. The waiting-screen moment, ready to paste into a mobility app. | `lucide-react`, `next` | [`components/widgets/ride-pickup-widget.tsx`](components/widgets/ride-pickup-widget.tsx) | [Guide](references/craft/ride-pickup.md) |
|
|
467
507
|
| **Sand Drift** | `sand-drift-background` | Layered desert dunes in stone and amber tones with fine grain — travel, hospitality, and calm wellness layouts. | None (core) | [`components/background-gradient/sand-drift-background.tsx`](components/background-gradient/sand-drift-background.tsx) | [Guide](references/craft/sand-drift-background.md) |
|
|
@@ -470,9 +510,11 @@ Ensure your `tailwind.config.js` or `globals.css` supports CSS variable colors (
|
|
|
470
510
|
| **Select Field Input** | `select-field-input` | Custom listbox select with styled dropdown, keyboard navigation, click-outside close, and hidden input for native form posts. | `lucide-react` | [`components/inputs/select-field-input.tsx`](components/inputs/select-field-input.tsx) | [Guide](references/craft/select-field-input.md) |
|
|
471
511
|
| **Share Menu** | `share-menu` | Square icon trigger opens a horizontal brand rail — four social tiles in a row plus a full-width copy button. | `lucide-react` | [`components/dropdowns/share-menu-dropdown.tsx`](components/dropdowns/share-menu-dropdown.tsx) | [Guide](references/craft/share-menu.md) |
|
|
472
512
|
| **Sheen Pill** | `sheen-pill-button` | Frosted pill with layered shade veil, light band, and rim wire — hover brightens the sheen and clears the fill. Pass width, height, and highlight to tune the frame. | None (core) | [`components/buttons/sheen-pill-button.tsx`](components/buttons/sheen-pill-button.tsx) | [Guide](references/craft/sheen-pill-button.md) |
|
|
513
|
+
| **Shiny Button** | `shiny-button` | Glossy button with high-contrast inner glow layers and a specular glint that sweeps across on every click. | None (core) | [`components/buttons/shiny-button.tsx`](components/buttons/shiny-button.tsx) | [Guide](references/craft/shiny-button.md) |
|
|
473
514
|
| **Slate Chip Switch** | `slate-chip-switch` | Smooth pill chip switch with a white thumb and sky on-state fill — a cleaner alternative to textured toggles. | None (core) | [`components/buttons/slate-chip-switch.tsx`](components/buttons/slate-chip-switch.tsx) | [Guide](references/craft/slate-chip-switch.md) |
|
|
474
515
|
| **Sleep Score** | `sleep-score` | Sleep score in the DND face layout — sleeping mascot at the bottom, score and quality above, duration tucked below. | `lucide-react` | [`components/widgets/sleep-score-widget.tsx`](components/widgets/sleep-score-widget.tsx) | [Guide](references/craft/sleep-score.md) |
|
|
475
516
|
| **Slide to Confirm** | `slide-to-confirm-button` | Drag the knob across the track to commit an action — snaps back if you release early, locks green when confirmed. Great for irreversible or high-intent actions. | `lucide-react` | [`components/buttons/slide-to-confirm-button.tsx`](components/buttons/slide-to-confirm-button.tsx) | [Guide](references/craft/slide-to-confirm-button.md) |
|
|
517
|
+
| **Slide to Detonate** | `slide-to-detonate` | Slide-to-confirm safety trigger that requires dragging a lock handle across a burning fuse to detonate. | `motion` | [`components/buttons/slide-to-detonate.tsx`](components/buttons/slide-to-detonate.tsx) | [Guide](references/craft/slide-to-detonate.md) |
|
|
476
518
|
| **Slow Living Polaroid** | `slow-living-polaroid` | Dark editorial layout with a taped, tilted polaroid and lowercase lifestyle copy. Slow living, coffee brands, quiet product launches. | `next` | [`components/gallery/slow-living-polaroid-card.tsx`](components/gallery/slow-living-polaroid-card.tsx) | [Guide](references/craft/slow-living-polaroid.md) |
|
|
477
519
|
| **Soft Spotlight** | `soft-spotlight-background` | Gallery stage light from above with a gentle vignette — product reveals, keynote heroes, and museum-style layouts. | None (core) | [`components/background-gradient/soft-spotlight-background.tsx`](components/background-gradient/soft-spotlight-background.tsx) | [Guide](references/craft/soft-spotlight-background.md) |
|
|
478
520
|
| **Spin Loader** | `spin-loader` | Minimal spinning loader built on a lucide icon — defaults to Loader, but pass any icon prop. Sizes: sm, md, lg. | `lucide-react` | [`components/loaders/spin-loader.tsx`](components/loaders/spin-loader.tsx) | [Guide](references/craft/spin-loader.md) |
|
|
@@ -481,6 +523,7 @@ Ensure your `tailwind.config.js` or `globals.css` supports CSS variable colors (
|
|
|
481
523
|
| **Stacked Folder Card** | `stacked-folder-card` | Three stacked folder cards with thick white borders and smooth hover rotation — back and middle peeks bring any card to the front. | `next` | [`components/files/stacked-folder-card.tsx`](components/files/stacked-folder-card.tsx) | [Guide](references/craft/stacked-folder-card.md) |
|
|
482
524
|
| **Stamp Postcard** | `stamp-postcard` | Vintage postcard with landscape photo, postage stamp overlay, handwritten message, and posted-from address. Travel and lifestyle brands love this one. | `next` | [`components/gallery/stamp-postcard-card.tsx`](components/gallery/stamp-postcard-card.tsx) | [Guide](references/craft/stamp-postcard.md) |
|
|
483
525
|
| **Step Count** | `step-count` | Editorial step stat — light wide card, large number, goal in a quiet footer row. No progress bars or icons. | None (core) | [`components/widgets/step-count-widget.tsx`](components/widgets/step-count-widget.tsx) | [Guide](references/craft/step-count.md) |
|
|
526
|
+
| **Sticky Button** | `sticky-button` | Magnetic cursor button pulled toward the pointer from a wide capture field with parallax tilt and depth. | `motion` | [`components/buttons/sticky-button.tsx`](components/buttons/sticky-button.tsx) | [Guide](references/craft/sticky-button.md) |
|
|
484
527
|
| **Sticky Note Polaroid Frame** | `sticky-note-polaroid-frame` | Polaroid-style frame with a paper-clipped sticky note overlay — pass noteHeader, noteBody, noteFooter, and any image or video as children. | None (core) | [`components/frames/sticky-note-polaroid-frame.tsx`](components/frames/sticky-note-polaroid-frame.tsx) | [Guide](references/craft/sticky-note-polaroid-frame.md) |
|
|
485
528
|
| **Stopwatch** | `stopwatch` | Millisecond-precision stopwatch with reset, play-pause, and stop in a compact white widget. Running state shown with a small indicator dot. | `lucide-react` | [`components/widgets/stopwatch-widget.tsx`](components/widgets/stopwatch-widget.tsx) | [Guide](references/craft/stopwatch.md) |
|
|
486
529
|
| **Sunrise Horizon** | `sunrise-horizon-background` | Warm dawn sky with peach horizon bands, a soft sun glow, and cool teal lift at the base — editorial hero sections and landing pages. | None (core) | [`components/background-gradient/sunrise-horizon-background.tsx`](components/background-gradient/sunrise-horizon-background.tsx) | [Guide](references/craft/sunrise-horizon-background.md) |
|
|
@@ -502,12 +545,14 @@ Ensure your `tailwind.config.js` or `globals.css` supports CSS variable colors (
|
|
|
502
545
|
| **Textarea Field Input** | `textarea-field-input` | Multiline field with live character count, max length guard, resize support, and the same label/hint/error pattern as text fields. | None (core) | [`components/inputs/textarea-field-input.tsx`](components/inputs/textarea-field-input.tsx) | [Guide](references/craft/textarea-field-input.md) |
|
|
503
546
|
| **Thermal Receipt** | `thermal-receipt` | Monospace receipt with line items, tax, total, perforated edges, and a QR footer. Reads like paper from a real register. | `lucide-react` | [`components/others/thermal-receipt-card.tsx`](components/others/thermal-receipt-card.tsx) | [Guide](references/craft/thermal-receipt.md) |
|
|
504
547
|
| **Threads Post** | `threads-post` | Threads-style post with avatar thread line, text, optional image, and engagement counts. Like toggles on tap. | `lucide-react`, `next` | [`components/socials/threads-post-card.tsx`](components/socials/threads-post-card.tsx) | [Guide](references/craft/threads-post.md) |
|
|
548
|
+
| **Thruster Button** | `thruster-button` | Air-jet thruster button that lifts off container floor and flies toward cursor with particle vapor trails. | `motion` | [`components/buttons/thruster-button.tsx`](components/buttons/thruster-button.tsx) | [Guide](references/craft/thruster-button.md) |
|
|
505
549
|
| **Toast Notification** | `toast-notification` | Light snackbar with check icon — message, undo action, slides up on dismiss. For save confirmations and quick feedback. | `lucide-react` | [`components/notifications/toast-notification-banner.tsx`](components/notifications/toast-notification-banner.tsx) | [Guide](references/craft/toast-notification.md) |
|
|
506
550
|
| **Toggle Pricing Cards** | `toggle-pricing-cards` | Monthly and yearly billing toggle that updates three plan cards side by side — price and feature checklist included. SaaS pricing page, one paste away. | `lucide-react` | [`components/pricing/toggle-pricing-cards.tsx`](components/pricing/toggle-pricing-cards.tsx) | [Guide](references/craft/toggle-pricing-cards.md) |
|
|
507
551
|
| **Torch Face** | `torch-face` | Yellow flashlight toggle with a face that lights up when the torch is on. Small detail, but the kind people notice on a control sheet. | `lucide-react` | [`components/widgets/torch-face-widget.tsx`](components/widgets/torch-face-widget.tsx) | [Guide](references/craft/torch-face.md) |
|
|
508
552
|
| **Transform Box Frame** | `transform-box-frame` | Design-tool bounding box with separate line and handle colors — defaults to all black; pass lineColor and handleColor for dual-tone frames. | None (core) | [`components/frames/transform-box-frame.tsx`](components/frames/transform-box-frame.tsx) | [Guide](references/craft/transform-box-frame.md) |
|
|
509
553
|
| **Transform Plus Frame** | `transform-plus-frame` | Bounding box with plus corner handles — thicker handle strokes than border lines. Defaults to all black; pass lineColor and handleColor for dual-tone frames. | None (core) | [`components/frames/transform-plus-frame.tsx`](components/frames/transform-plus-frame.tsx) | [Guide](references/craft/transform-plus-frame.md) |
|
|
510
554
|
| **Travel Postcard** | `travel-postcard` | Vintage sepia postcard with map badge, greeting title, location, and author signature. Wanderlust landing pages and newsletter headers. | `lucide-react`, `next` | [`components/travel/travel-postcard-card.tsx`](components/travel/travel-postcard-card.tsx) | [Guide](references/craft/travel-postcard.md) |
|
|
555
|
+
| **Troll Button** | `troll-button` | Playful button that evasively dodges the cursor until exhausting stamina, finally surrendering to be clicked. | `motion` | [`components/buttons/troll-button.tsx`](components/buttons/troll-button.tsx) | [Guide](references/craft/troll-button.md) |
|
|
511
556
|
| **Tropical Tide** | `tropical-tide-background` | Vibrant aurora wash in turquoise, lime, sky blue, and sea green — travel, resorts, and summer product drops. | None (core) | [`components/background-gradient/tropical-tide-background.tsx`](components/background-gradient/tropical-tide-background.tsx) | [Guide](references/craft/tropical-tide-background.md) |
|
|
512
557
|
| **Twitter Post** | `twitter-post` | Tweet card with avatar, handle, timestamp, hashtags, and full engagement row. For social embeds, mockups, or feed previews. | `lucide-react`, `next` | [`components/socials/twitter-post-card.tsx`](components/socials/twitter-post-card.tsx) | [Guide](references/craft/twitter-post.md) |
|
|
513
558
|
| **Twitter Profile** | `twitter-profile` | Twitter/X profile with cover, avatar, bio, location, website link, and follower counts. Follow button included. | `lucide-react`, `next` | [`components/socials/twitter-profile-card.tsx`](components/socials/twitter-profile-card.tsx) | [Guide](references/craft/twitter-profile.md) |
|
|
@@ -531,7 +576,10 @@ Ensure your `tailwind.config.js` or `globals.css` supports CSS variable colors (
|
|
|
531
576
|
- [Motion Engineering Guide](./references/guides/motion-engineering.md): Motion v12/v13+ architecture, spring formulas, shared layoutId morphs, and AnimatePresence.
|
|
532
577
|
- [Motion Performance & 60/120 FPS](./references/guides/motion-performance.md): Compositor properties, avoiding layout thrashing, and layer budgets.
|
|
533
578
|
- [Baseline UI Craft & Anti-Slop](./references/guides/baseline-ui-craft.md): Design engineering principles, optical alignment, spacing rhythm, and micro-interactions.
|
|
534
|
-
- [The
|
|
579
|
+
- [The Canonical Interaction Transitions Guide](./references/guides/interaction-transitions.md): Transitions.dev interaction patterns, 43 canonical transitions, and token specs.
|
|
580
|
+
- [Motion Polish & Interaction Rules Guide](./references/guides/motion-polish-rules.md): Micro-distance scales (4px, 6px, 8px, 12px, 30px) and progressive UI generation.
|
|
581
|
+
- [Design Intelligence & UI Reasoning Guide](./references/guides/design-intelligence.md): 67 UI style families, industry-mapped color palettes, font pairings, chart selectors, and CRO landing architectures.
|
|
582
|
+
- [Modern Stack Best Practices Guide](./references/guides/stack-best-practices.md): Framework integration guidelines covering Next.js App Router, React 19, Tailwind v3/v4, and Motion.
|
|
535
583
|
- [Universal Mobile-First Interaction Patterns](./references/guides/universal-mobile-patterns.md): Touch ergonomics, haptic feedback semantics, and swipe gestures.
|
|
536
584
|
- [Craft & Surface Design System](./references/guides/craft-surface-design-system.md): Visual language, tactile 3D elevation, typography pairing, and component patterns.
|
|
537
585
|
- [Enterprise Dashboard Architecture](./references/guides/enterprise-dashboard-patterns.md): High-density data grids, kanban boards, faceted query builders, and timelines.
|
|
@@ -588,7 +636,7 @@ python scripts/test_release.py
|
|
|
588
636
|
python evals/catalog_eval.py
|
|
589
637
|
```
|
|
590
638
|
|
|
591
|
-
The checks cover the
|
|
639
|
+
The checks cover the 384-component catalog, referenced files, installer safety, generated docs, dependency coverage, and the source-reference exclusion rule.
|
|
592
640
|
|
|
593
641
|
---
|
|
594
642
|
|
|
@@ -599,12 +647,13 @@ motion-ui-skill/
|
|
|
599
647
|
├── README.md # Comprehensive guide & installation instructions
|
|
600
648
|
├── SKILL.md # Main agent skill definition with catalog & instructions
|
|
601
649
|
├── agents/openai.yaml # Codex skill-list metadata and default prompt
|
|
602
|
-
├── catalog.json # Machine-readable metadata for all
|
|
650
|
+
├── catalog.json # Machine-readable metadata for all 384 components
|
|
603
651
|
├── components/ # Production TypeScript/React source code
|
|
604
|
-
│ ├── motion/ #
|
|
605
|
-
│ ├── agents/ #
|
|
652
|
+
│ ├── motion/ # 97 motion primitives and composed blocks
|
|
653
|
+
│ ├── agents/ # 18 conversational agent surfaces
|
|
606
654
|
│ ├── previews/ # Component preview & demo implementations
|
|
607
|
-
│ └── [category]/ #
|
|
655
|
+
│ └── [category]/ # 236 craft & surface component files across categories
|
|
656
|
+
├── data/ # Design intelligence datasets (styles, colors, typography, charts, stacks)
|
|
608
657
|
├── icons/ # 21 custom brand and annotation icons
|
|
609
658
|
├── lib/ # Foundation tokens, easing physics, and utility hooks
|
|
610
659
|
│ ├── ease.ts # Easing curves and spring physics constants
|
|
@@ -613,17 +662,18 @@ motion-ui-skill/
|
|
|
613
662
|
│ ├── cn.ts # cn() re-export
|
|
614
663
|
│ └── hooks/ # Custom hooks (use-haptic, use-dismiss, use-measure, etc.)
|
|
615
664
|
├── references/ # Offline-first detailed markdown component documentation
|
|
616
|
-
│ ├── motion/ #
|
|
617
|
-
│ ├── agents/ #
|
|
665
|
+
│ ├── motion/ # 107 component guides with props & examples
|
|
666
|
+
│ ├── agents/ # 18 agent component guides
|
|
618
667
|
│ ├── blocks/ # 23 block guides
|
|
619
|
-
│ ├── craft/ #
|
|
620
|
-
│ ├── guides/ # Complete suite of
|
|
668
|
+
│ ├── craft/ # 236 craft and surface component guides
|
|
669
|
+
│ ├── guides/ # Complete suite of 13 motion & design system guides
|
|
621
670
|
│ └── codex-install.md # Codex app and CLI installation guide
|
|
622
671
|
├── prompts/
|
|
623
672
|
│ └── install-motion-ui.md # Copy-paste prompt for AI-agent installation
|
|
624
673
|
├── evals/
|
|
625
674
|
│ └── catalog_eval.py # Dependency-free catalog coverage evaluation
|
|
626
675
|
└── scripts/
|
|
676
|
+
├── search.py # Terminal design reasoning search engine (BM25)
|
|
627
677
|
├── install-component.py # Standalone CLI tool to install components into projects
|
|
628
678
|
├── build_docs.py # Script to synchronize SKILL.md and README.md from catalog
|
|
629
679
|
├── verify_skill.py # Dependency-free package integrity gate
|