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/SKILL.md
CHANGED
|
@@ -2,17 +2,17 @@
|
|
|
2
2
|
name: motion-ui
|
|
3
3
|
description: >-
|
|
4
4
|
Production-ready animated UI component library for React and Next.js built with Motion (Framer Motion)
|
|
5
|
-
and Tailwind CSS. Includes
|
|
5
|
+
and Tailwind CSS. Includes 384 interactive components across 4 categories: Motion Primitives (97 components), AI Agent Surfaces (18 components), Blocks & Widgets (33 components), and Craft & Surface Components (236 components: tactile 3D buttons, neumorphic controls, device mockups, background gradients & patterns, calendar widgets, data tables, editorial typography, and interactive cards). Supports 6 aesthetic style presets (minimal, origin, enterprise, glow, ios, brutalist).
|
|
6
6
|
Includes local Codex installation instructions, comprehensive design system guides, and an AI-agent install prompt.
|
|
7
7
|
license: MIT
|
|
8
8
|
metadata:
|
|
9
9
|
author: Rkj0123
|
|
10
|
-
version: "2.
|
|
10
|
+
version: "2.1.0"
|
|
11
11
|
---
|
|
12
12
|
|
|
13
13
|
# Motion UI Skill
|
|
14
14
|
|
|
15
|
-
> Complete offline repository of **
|
|
15
|
+
> Complete offline repository of **384 production-ready animated UI components** for React and Next.js, built with **Motion** (`motion/react` / `framer-motion`) and **Tailwind CSS**.
|
|
16
16
|
|
|
17
17
|
This skill is **self-contained and offline-first** for the bundled components. All source code, shared animation utilities, hooks, physics tokens, component guides, and Codex setup instructions exist directly in this repository.
|
|
18
18
|
|
|
@@ -117,7 +117,7 @@ When the user asks for any animated component, UI widget, micro-interaction, or
|
|
|
117
117
|
```
|
|
118
118
|
*(Or from the consuming project: `node .agents/skills/motion-ui/bin/updater.mjs --silent`). If an upstream update exists, it auto-updates before proceeding.*
|
|
119
119
|
|
|
120
|
-
1. **Locate the Component**: Find the matching component from the
|
|
120
|
+
1. **Locate the Component**: Find the matching component from the 384 components listed in the catalog below or in [`catalog.json`](./catalog.json).
|
|
121
121
|
2. **Read Component Source & Docs**:
|
|
122
122
|
- Inspect the `Primary File` path in the matching catalog entry.
|
|
123
123
|
- Read the `doc_path` file from that same catalog entry for props, variants, and examples.
|
|
@@ -141,9 +141,9 @@ When the user asks to install this skill in Codex specifically, read [`reference
|
|
|
141
141
|
|
|
142
142
|
---
|
|
143
143
|
|
|
144
|
-
## Component Catalog (
|
|
144
|
+
## Component Catalog (384 Components)
|
|
145
145
|
|
|
146
|
-
### Category 1: Motion Components (
|
|
146
|
+
### Category 1: Motion Components (97 Components)
|
|
147
147
|
Interactive, animated primitives including buttons, inputs, tabs, modals, bottom sheets, sliders, accordions, sidebars, and loaders.
|
|
148
148
|
|
|
149
149
|
| Component | Slug | Description | Dependencies | Primary File | Docs |
|
|
@@ -158,6 +158,7 @@ Interactive, animated primitives including buttons, inputs, tabs, modals, bottom
|
|
|
158
158
|
| **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) |
|
|
159
159
|
| **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) |
|
|
160
160
|
| **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) |
|
|
161
|
+
| **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) |
|
|
161
162
|
| **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) |
|
|
162
163
|
| **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) |
|
|
163
164
|
| **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) |
|
|
@@ -175,30 +176,41 @@ Interactive, animated primitives including buttons, inputs, tabs, modals, bottom
|
|
|
175
176
|
| **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) |
|
|
176
177
|
| **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) |
|
|
177
178
|
| **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) |
|
|
179
|
+
| **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) |
|
|
178
180
|
| **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) |
|
|
181
|
+
| **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) |
|
|
182
|
+
| **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) |
|
|
179
183
|
| **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) |
|
|
184
|
+
| **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) |
|
|
180
185
|
| **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) |
|
|
181
186
|
| **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) |
|
|
182
187
|
| **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) |
|
|
188
|
+
| **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) |
|
|
183
189
|
| **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) |
|
|
184
190
|
| **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) |
|
|
185
191
|
| **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) |
|
|
186
192
|
| **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) |
|
|
193
|
+
| **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) |
|
|
187
194
|
| **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) |
|
|
195
|
+
| **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) |
|
|
188
196
|
| **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) |
|
|
197
|
+
| **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) |
|
|
189
198
|
| **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) |
|
|
190
199
|
| **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) |
|
|
191
200
|
| **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) |
|
|
201
|
+
| **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) |
|
|
192
202
|
| **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) |
|
|
193
203
|
| **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) |
|
|
194
204
|
| **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) |
|
|
195
205
|
| **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) |
|
|
206
|
+
| **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) |
|
|
196
207
|
| **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) |
|
|
197
208
|
| **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) |
|
|
198
209
|
| **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) |
|
|
199
210
|
| **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) |
|
|
200
211
|
| **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) |
|
|
201
212
|
| **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) |
|
|
213
|
+
| **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) |
|
|
202
214
|
| **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) |
|
|
203
215
|
| **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) |
|
|
204
216
|
| **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) |
|
|
@@ -210,8 +222,11 @@ Interactive, animated primitives including buttons, inputs, tabs, modals, bottom
|
|
|
210
222
|
| **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) |
|
|
211
223
|
| **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) |
|
|
212
224
|
| **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) |
|
|
225
|
+
| **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) |
|
|
213
226
|
| **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) |
|
|
214
227
|
| **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) |
|
|
228
|
+
| **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) |
|
|
229
|
+
| **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) |
|
|
215
230
|
| **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) |
|
|
216
231
|
| **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) |
|
|
217
232
|
| **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) |
|
|
@@ -220,7 +235,9 @@ Interactive, animated primitives including buttons, inputs, tabs, modals, bottom
|
|
|
220
235
|
| **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) |
|
|
221
236
|
| **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) |
|
|
222
237
|
| **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) |
|
|
238
|
+
| **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) |
|
|
223
239
|
| **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) |
|
|
240
|
+
| **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) |
|
|
224
241
|
| **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) |
|
|
225
242
|
| **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) |
|
|
226
243
|
| **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) |
|
|
@@ -231,7 +248,7 @@ Interactive, animated primitives including buttons, inputs, tabs, modals, bottom
|
|
|
231
248
|
|
|
232
249
|
---
|
|
233
250
|
|
|
234
|
-
### Category 2: AI Agent Surfaces (
|
|
251
|
+
### Category 2: AI Agent Surfaces (18 Components)
|
|
235
252
|
Specialized UI surfaces for conversational agent interfaces: message bubbles, scrollers, prompt inputs, approval cards, code blocks, diffs, tool activity, and streaming responses.
|
|
236
253
|
|
|
237
254
|
| Component | Slug | Description | Dependencies | Primary File | Docs |
|
|
@@ -250,6 +267,7 @@ Specialized UI surfaces for conversational agent interfaces: message bubbles, sc
|
|
|
250
267
|
| **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) |
|
|
251
268
|
| **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) |
|
|
252
269
|
| **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) |
|
|
270
|
+
| **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) |
|
|
253
271
|
| **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) |
|
|
254
272
|
| **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) |
|
|
255
273
|
| **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) |
|
|
@@ -297,7 +315,7 @@ Complex composable animated UI widgets: kanban boards, filter builders, action s
|
|
|
297
315
|
|
|
298
316
|
---
|
|
299
317
|
|
|
300
|
-
### Category 4: Craft & Surface Components (
|
|
318
|
+
### Category 4: Craft & Surface Components (236 Components)
|
|
301
319
|
Tactile 3D buttons, neumorphic controls, high-fidelity device mockups, background gradients & patterns, calendar widgets, data tables, editorial typography, and interactive surface cards.
|
|
302
320
|
|
|
303
321
|
| Component | Slug | Description | Dependencies | Primary File | Docs |
|
|
@@ -316,7 +334,9 @@ Tactile 3D buttons, neumorphic controls, high-fidelity device mockups, backgroun
|
|
|
316
334
|
| **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) |
|
|
317
335
|
| **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) |
|
|
318
336
|
| **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) |
|
|
337
|
+
| **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) |
|
|
319
338
|
| **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) |
|
|
339
|
+
| **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) |
|
|
320
340
|
| **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) |
|
|
321
341
|
| **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) |
|
|
322
342
|
| **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) |
|
|
@@ -324,18 +344,24 @@ Tactile 3D buttons, neumorphic controls, high-fidelity device mockups, backgroun
|
|
|
324
344
|
| **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) |
|
|
325
345
|
| **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) |
|
|
326
346
|
| **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) |
|
|
347
|
+
| **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) |
|
|
327
348
|
| **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) |
|
|
328
349
|
| **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) |
|
|
329
350
|
| **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) |
|
|
330
351
|
| **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) |
|
|
331
352
|
| **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) |
|
|
353
|
+
| **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) |
|
|
332
354
|
| **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) |
|
|
333
355
|
| **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) |
|
|
334
356
|
| **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) |
|
|
357
|
+
| **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) |
|
|
335
358
|
| **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) |
|
|
359
|
+
| **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) |
|
|
336
360
|
| **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) |
|
|
361
|
+
| **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) |
|
|
337
362
|
| **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) |
|
|
338
363
|
| **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) |
|
|
364
|
+
| **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) |
|
|
339
365
|
| **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) |
|
|
340
366
|
| **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) |
|
|
341
367
|
| **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) |
|
|
@@ -354,14 +380,17 @@ Tactile 3D buttons, neumorphic controls, high-fidelity device mockups, backgroun
|
|
|
354
380
|
| **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) |
|
|
355
381
|
| **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) |
|
|
356
382
|
| **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) |
|
|
383
|
+
| **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) |
|
|
357
384
|
| **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) |
|
|
358
385
|
| **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) |
|
|
359
386
|
| **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) |
|
|
360
387
|
| **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) |
|
|
361
388
|
| **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) |
|
|
362
389
|
| **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) |
|
|
390
|
+
| **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) |
|
|
363
391
|
| **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) |
|
|
364
392
|
| **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) |
|
|
393
|
+
| **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) |
|
|
365
394
|
| **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) |
|
|
366
395
|
| **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) |
|
|
367
396
|
| **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) |
|
|
@@ -371,6 +400,7 @@ Tactile 3D buttons, neumorphic controls, high-fidelity device mockups, backgroun
|
|
|
371
400
|
| **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) |
|
|
372
401
|
| **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) |
|
|
373
402
|
| **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) |
|
|
403
|
+
| **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) |
|
|
374
404
|
| **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) |
|
|
375
405
|
| **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) |
|
|
376
406
|
| **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) |
|
|
@@ -385,16 +415,20 @@ Tactile 3D buttons, neumorphic controls, high-fidelity device mockups, backgroun
|
|
|
385
415
|
| **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) |
|
|
386
416
|
| **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) |
|
|
387
417
|
| **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) |
|
|
418
|
+
| **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) |
|
|
388
419
|
| **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) |
|
|
389
420
|
| **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) |
|
|
390
421
|
| **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) |
|
|
391
422
|
| **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) |
|
|
392
423
|
| **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) |
|
|
393
424
|
| **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) |
|
|
425
|
+
| **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) |
|
|
394
426
|
| **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) |
|
|
395
427
|
| **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) |
|
|
396
428
|
| **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) |
|
|
397
429
|
| **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) |
|
|
430
|
+
| **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) |
|
|
431
|
+
| **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) |
|
|
398
432
|
| **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) |
|
|
399
433
|
| **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) |
|
|
400
434
|
| **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) |
|
|
@@ -419,9 +453,13 @@ Tactile 3D buttons, neumorphic controls, high-fidelity device mockups, backgroun
|
|
|
419
453
|
| **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) |
|
|
420
454
|
| **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) |
|
|
421
455
|
| **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) |
|
|
456
|
+
| **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) |
|
|
422
457
|
| **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) |
|
|
458
|
+
| **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) |
|
|
423
459
|
| **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) |
|
|
424
460
|
| **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) |
|
|
461
|
+
| **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) |
|
|
462
|
+
| **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) |
|
|
425
463
|
| **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) |
|
|
426
464
|
| **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) |
|
|
427
465
|
| **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) |
|
|
@@ -448,11 +486,13 @@ Tactile 3D buttons, neumorphic controls, high-fidelity device mockups, backgroun
|
|
|
448
486
|
| **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) |
|
|
449
487
|
| **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) |
|
|
450
488
|
| **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) |
|
|
489
|
+
| **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) |
|
|
451
490
|
| **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) |
|
|
452
491
|
| **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) |
|
|
453
492
|
| **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) |
|
|
454
493
|
| **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) |
|
|
455
494
|
| **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) |
|
|
495
|
+
| **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) |
|
|
456
496
|
| **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) |
|
|
457
497
|
| **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) |
|
|
458
498
|
| **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) |
|
|
@@ -461,9 +501,11 @@ Tactile 3D buttons, neumorphic controls, high-fidelity device mockups, backgroun
|
|
|
461
501
|
| **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) |
|
|
462
502
|
| **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) |
|
|
463
503
|
| **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) |
|
|
504
|
+
| **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) |
|
|
464
505
|
| **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) |
|
|
465
506
|
| **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) |
|
|
466
507
|
| **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) |
|
|
508
|
+
| **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) |
|
|
467
509
|
| **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) |
|
|
468
510
|
| **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) |
|
|
469
511
|
| **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) |
|
|
@@ -472,6 +514,7 @@ Tactile 3D buttons, neumorphic controls, high-fidelity device mockups, backgroun
|
|
|
472
514
|
| **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) |
|
|
473
515
|
| **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) |
|
|
474
516
|
| **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) |
|
|
517
|
+
| **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) |
|
|
475
518
|
| **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) |
|
|
476
519
|
| **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) |
|
|
477
520
|
| **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) |
|
|
@@ -493,12 +536,14 @@ Tactile 3D buttons, neumorphic controls, high-fidelity device mockups, backgroun
|
|
|
493
536
|
| **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) |
|
|
494
537
|
| **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) |
|
|
495
538
|
| **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) |
|
|
539
|
+
| **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) |
|
|
496
540
|
| **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) |
|
|
497
541
|
| **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) |
|
|
498
542
|
| **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) |
|
|
499
543
|
| **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) |
|
|
500
544
|
| **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) |
|
|
501
545
|
| **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) |
|
|
546
|
+
| **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) |
|
|
502
547
|
| **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) |
|
|
503
548
|
| **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) |
|
|
504
549
|
| **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) |
|
|
@@ -514,6 +559,32 @@ Tactile 3D buttons, neumorphic controls, high-fidelity device mockups, backgroun
|
|
|
514
559
|
|
|
515
560
|
---
|
|
516
561
|
|
|
562
|
+
## Design Search Engine & UI Reasoning
|
|
563
|
+
|
|
564
|
+
Search across 67 UI style families, industry-mapped color palettes, font pairings, chart selectors, and stack guidelines:
|
|
565
|
+
|
|
566
|
+
```bash
|
|
567
|
+
# Search by style (e.g. glassmorphism, brutalism, minimal, retro, bento)
|
|
568
|
+
python scripts/search.py "glassmorphism" --domain style
|
|
569
|
+
|
|
570
|
+
# Search industry color palette (e.g. fintech, saas, healthcare, devtools)
|
|
571
|
+
python scripts/search.py "fintech" --domain color
|
|
572
|
+
|
|
573
|
+
# Search typography pairings (e.g. editorial, technical, playful, modern)
|
|
574
|
+
python scripts/search.py "editorial" --domain typography
|
|
575
|
+
|
|
576
|
+
# Search optimal chart type (e.g. time series, retention, distribution, comparison)
|
|
577
|
+
python scripts/search.py "retention" --domain chart
|
|
578
|
+
|
|
579
|
+
# Search UX best practices (e.g. modal, checkout, form, error)
|
|
580
|
+
python scripts/search.py "form" --domain ux
|
|
581
|
+
|
|
582
|
+
# Generate a complete cohesive design system for a product domain
|
|
583
|
+
python scripts/search.py "Crypto Trading Platform" --design-system
|
|
584
|
+
```
|
|
585
|
+
|
|
586
|
+
---
|
|
587
|
+
|
|
517
588
|
## Motion Guides & Best Practices
|
|
518
589
|
|
|
519
590
|
For in-depth animation principles, design system checklists, and accessibility rules, read:
|
|
@@ -523,7 +594,10 @@ For in-depth animation principles, design system checklists, and accessibility r
|
|
|
523
594
|
- [`references/guides/motion-engineering.md`](./references/guides/motion-engineering.md): Deep dive into `motion/react`, physics-based springs, `layoutId`, `AnimatePresence`, gestures, and hardware acceleration.
|
|
524
595
|
- [`references/guides/motion-performance.md`](./references/guides/motion-performance.md): 60/120 FPS animation performance guide covering compositor-only properties, avoiding layout thrashing, and layer budgets.
|
|
525
596
|
- [`references/guides/baseline-ui-craft.md`](./references/guides/baseline-ui-craft.md): Design Engineer craft principles: optical alignment, spacing rhythm, accessible focus rings, and micro-interactions.
|
|
526
|
-
- [`references/guides/interaction-transitions.md`](./references/guides/interaction-transitions.md): The
|
|
597
|
+
- [`references/guides/interaction-transitions.md`](./references/guides/interaction-transitions.md): The canonical 43 interaction transitions from Transitions.dev with token specs and timing tables.
|
|
598
|
+
- [`references/guides/motion-polish-rules.md`](./references/guides/motion-polish-rules.md): Complete micro-distance (4px, 6px, 8px, 12px, 30px) and timing rules from Transitions.dev.
|
|
599
|
+
- [`references/guides/design-intelligence.md`](./references/guides/design-intelligence.md): Master design intelligence guide synthesizing 67 UI styles, industry color systems, font pairings, chart selection, and CRO landing architectures.
|
|
600
|
+
- [`references/guides/stack-best-practices.md`](./references/guides/stack-best-practices.md): Framework integration guidelines covering Next.js App Router, React 19, Tailwind v3/v4, and Motion.
|
|
527
601
|
- [`references/guides/universal-mobile-patterns.md`](./references/guides/universal-mobile-patterns.md): Cross-platform mobile interaction patterns, touch ergonomics (44pt/48dp rules), and semantic haptics.
|
|
528
602
|
- [`references/guides/craft-surface-design-system.md`](./references/guides/craft-surface-design-system.md): Craft & Surface Design System covering neutral stages, tactile 3D elevation, typography pairing, and component patterns.
|
|
529
603
|
- [`references/guides/enterprise-dashboard-patterns.md`](./references/guides/enterprise-dashboard-patterns.md): Architecture for complex enterprise surfaces, timelines, kanban task boards, faceted query builders, and data grids.
|
package/bin/index.mjs
CHANGED
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
* Supports:
|
|
6
6
|
* - npx motion-ui-skill (auto-detects and installs skill)
|
|
7
7
|
* - motion-ui-skill update (checks upstream and updates skill)
|
|
8
|
-
* - motion-ui-skill search <query> (searches
|
|
8
|
+
* - motion-ui-skill search <query> (searches 384 components)
|
|
9
9
|
* - motion-ui-skill list [category] (lists components)
|
|
10
10
|
* - motion-ui-skill add <slug> (installs component into project)
|
|
11
11
|
*/
|
|
@@ -44,7 +44,7 @@ COMMANDS:
|
|
|
44
44
|
Flags: --all / -y, --global, --dry-run, --list
|
|
45
45
|
update Check upstream for updates and auto-update
|
|
46
46
|
Flags: --force, --silent
|
|
47
|
-
search <query> Search
|
|
47
|
+
search <query> Search 384 components by name, tag, or description
|
|
48
48
|
list [category] List components (motion, agents, blocks, craft)
|
|
49
49
|
add <slug> Install component files into your project
|
|
50
50
|
Flags: --dest <dir> (default: ./src), --style <preset>
|
package/bin/installer.mjs
CHANGED
|
@@ -34,6 +34,12 @@ const c = (color, text) => `${COLORS[color]}${text}${COLORS.reset}`;
|
|
|
34
34
|
// Files and directories to copy when installing the skill
|
|
35
35
|
const SKILL_COPY_ITEMS = [
|
|
36
36
|
"SKILL.md",
|
|
37
|
+
"README.md",
|
|
38
|
+
"data",
|
|
39
|
+
"icons",
|
|
40
|
+
"prompts",
|
|
41
|
+
"evals",
|
|
42
|
+
"test",
|
|
37
43
|
"catalog.json",
|
|
38
44
|
"package.json",
|
|
39
45
|
"agents",
|