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
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: "Motion Polish & Interaction Rules Guide"
|
|
3
|
+
description: "Master motion polish, micro-distance formulas, layer budgets, and progressive skeleton generation rules synthesized from Transitions.dev."
|
|
4
|
+
documentation: "references/guides/motion-polish-rules.md"
|
|
5
|
+
markdown: "references/guides/motion-polish-rules.md"
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Motion Polish & Interaction Rules Guide
|
|
9
|
+
|
|
10
|
+
> Synthesized from [transitions.dev](https://github.com/Jakubantalik/transitions.dev) by Jakub Antalík (`transitions-polish` and `transitions-ui-generation`).
|
|
11
|
+
|
|
12
|
+
Micro-interactions separate amateur interfaces from world-class software. To achieve physical, organic UI that never feels stiff or floaty, apply these exact distance formulas, timing scales, and compositor constraints.
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## 1. The 5 Canonical Micro-Distance Rules
|
|
17
|
+
|
|
18
|
+
Never pick random pixel translation values. All motion distances are categorized by functional usage:
|
|
19
|
+
|
|
20
|
+
| Scale | Offset Distance | Interaction Usage | Physics Curve / Duration |
|
|
21
|
+
| :--- | :--- | :--- | :--- |
|
|
22
|
+
| **Micro** | `4px` | Label state swaps, button icon nudges, inline pill trades | `SPRING_SWAP` or `150ms` |
|
|
23
|
+
| **Small** | `6px` | Error input shakes, badge pop-ins, small segment switches | `Keyframe oscillate [-4px, 4px, -2px, 0]` |
|
|
24
|
+
| **Base** | `8px` | Modal dialog reveals, page step slides, dropdown menus | `cubic-bezier(0.16, 1, 0.3, 1)` / `220ms` |
|
|
25
|
+
| **Medium** | `12px` | Word-by-word typographic reveals, floating tooltip entrances | `EASE_OUT` / `280ms` |
|
|
26
|
+
| **Large** | `30px+` | Bottom drawer reveals, full-screen overlay expansions | `SPRING_PANEL` / `350ms` |
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## 2. Timing Tables & Spring Physics Constants
|
|
31
|
+
|
|
32
|
+
### Cubic-Bezier Curves
|
|
33
|
+
- `EASE_OUT` (`[0.16, 1, 0.3, 1]`): Standard entrance for cards, menus, and text elements.
|
|
34
|
+
- `EASE_IN_OUT` (`[0.77, 0, 0.175, 1]`): Reversible position changes between two fixed points.
|
|
35
|
+
- `EASE_DRAWER` (`[0.32, 0.72, 0, 1]`): High-inertia lateral drawers with soft deceleration.
|
|
36
|
+
- `EASE_EMPHASIZED` (`[0.2, 0, 0, 1]`): Material Design 3 and Android spatial transitions.
|
|
37
|
+
|
|
38
|
+
### Spring Tokens
|
|
39
|
+
- **Tappable Surface Press (`SPRING_PRESS`)**: `stiffness: 500, damping: 30, mass: 0.6`
|
|
40
|
+
- **Slot Trades & Swaps (`SPRING_SWAP`)**: `stiffness: 460, damping: 30, mass: 0.55`
|
|
41
|
+
- **Overlay Panels & Modals (`SPRING_PANEL`)**: `stiffness: 420, damping: 40, mass: 0.5`
|
|
42
|
+
- **Playful Pops & Badges (`SPRING_BOUNCE`)**: `stiffness: 300, damping: 18, mass: 0.8`
|
|
43
|
+
- **Cursor Tracking Parallax (`SPRING_MOUSE`)**: `stiffness: 200, damping: 15, mass: 0.3`
|
|
44
|
+
|
|
45
|
+
---
|
|
46
|
+
|
|
47
|
+
## 3. Progressive UI Generation & Zero-CLS Formula
|
|
48
|
+
|
|
49
|
+
When streaming or fetching asynchronous content, follow the 3-step progressive reveal:
|
|
50
|
+
|
|
51
|
+
1. **Exact Footprint Preservation**:
|
|
52
|
+
- The skeleton container must have the identical `min-height`, `padding`, `border-radius`, and `max-width` as the target populated card.
|
|
53
|
+
- Zero Cumulative Layout Shift (CLS score must remain `< 0.01`).
|
|
54
|
+
|
|
55
|
+
2. **Rhythmic Shimmer Phase**:
|
|
56
|
+
- Skeletons use continuous gradient sweeps (`bg-gradient-to-r from-transparent via-neutral-300/20 to-transparent`) at a 2.4s cycle with 1.2s rest.
|
|
57
|
+
|
|
58
|
+
3. **Directional Blur Cross-Fade**:
|
|
59
|
+
- When data arrives, the skeleton exits with `opacity: 0, filter: blur(4px)`.
|
|
60
|
+
- The live card enters simultaneously with `opacity: 1, filter: blur(0px), scale: 1` using `SPRING_PANEL`.
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
64
|
+
## 4. Hardware Acceleration & Layer Budgets
|
|
65
|
+
|
|
66
|
+
- **Animate only compositor properties**:
|
|
67
|
+
- `transform` (`translate`, `scale`, `rotate`, `skew`)
|
|
68
|
+
- `opacity`
|
|
69
|
+
- `filter` (`blur`)
|
|
70
|
+
- **Never animate layout triggers in hot loops**:
|
|
71
|
+
- `width`, `height`, `top`, `left`, `margin`, `padding` trigger browser reflow and layout recalculation on every frame.
|
|
72
|
+
- When container bounds must resize (such as tabs or cards), use Motion's `layout` and `layoutId` props, which translate bounding boxes via hardware-accelerated matrix transforms.
|
|
73
|
+
- **`prefers-reduced-motion` Enforcement**:
|
|
74
|
+
- All components must respect user accessibility settings via `useReducedMotion()`.
|
|
75
|
+
- When reduced motion is requested, replace spatial displacements with instantaneous or subtle opacity-only fades (`duration: 0.15s`).
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: "Modern Stack Best Practices Guide"
|
|
3
|
+
description: "Framework integration guidelines for Next.js App Router, React 19, Tailwind CSS v3/v4, and Motion."
|
|
4
|
+
documentation: "references/guides/stack-best-practices.md"
|
|
5
|
+
markdown: "references/guides/stack-best-practices.md"
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Modern Stack Best Practices Guide
|
|
9
|
+
|
|
10
|
+
> Synthesized from `data/stacks/` for production-grade React, Next.js, and Tailwind CSS development.
|
|
11
|
+
|
|
12
|
+
## 1. Next.js App Router Integration
|
|
13
|
+
|
|
14
|
+
- **Server vs Client Components**:
|
|
15
|
+
- Keep route layouts and page data fetching in Server Components (`async function Page()`).
|
|
16
|
+
- Isolate animated surfaces into Client Components marked with `"use client";` at the top of the file.
|
|
17
|
+
- Pass server-fetched data into client components via serializable props.
|
|
18
|
+
- **View Transitions**:
|
|
19
|
+
- Utilize React 19 `useTransition` and native `document.startViewTransition()` for smooth page transitions without flashing blank states.
|
|
20
|
+
- Pair with `layoutId` for shared-element morphs across route boundaries.
|
|
21
|
+
|
|
22
|
+
## 2. React 19 & State Primitives
|
|
23
|
+
|
|
24
|
+
- **Optimistic UI Updates**:
|
|
25
|
+
- Use `useOptimistic` to instantly reflect button clicks, toggles, or list additions before API verification.
|
|
26
|
+
- **Form Actions & Async State**:
|
|
27
|
+
- Use `useActionState` to manage pending, error, and success states for forms, pairing with `MorphStatusButton` or `HoldButton`.
|
|
28
|
+
- **Ref as Prop**:
|
|
29
|
+
- React 19 passes `ref` directly as a component prop without requiring `forwardRef` wrapping.
|
|
30
|
+
|
|
31
|
+
## 3. Tailwind CSS & Motion Harmonization
|
|
32
|
+
|
|
33
|
+
- **Utility Classes & cn()**:
|
|
34
|
+
- Always merge dynamic classes using `cn()` from `@/lib/utils` (`clsx` + `tailwind-merge`).
|
|
35
|
+
- Do not concatenate raw string classes with `+` or template strings without `cn()`.
|
|
36
|
+
- **Motion Component Styling**:
|
|
37
|
+
- Use Tailwind for visual geometry, typography, colors, and shadows.
|
|
38
|
+
- Use Motion (`motion/react` or `framer-motion`) for dynamic springs, gesture tracking, physics, and exit transitions.
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: "Banner Stacking"
|
|
3
|
+
description: "Stackable announcement and toast notification deck where new alerts rise in while older items scale down and recede with spring physics."
|
|
4
|
+
category: "Motion"
|
|
5
|
+
publishedAt: "2026-10-21"
|
|
6
|
+
updatedAt: "2026-10-21"
|
|
7
|
+
documentation: "references/motion/banner-stacking.md"
|
|
8
|
+
markdown: "references/motion/banner-stacking.md"
|
|
9
|
+
license: "MIT"
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# Banner Stacking
|
|
13
|
+
|
|
14
|
+
> Stackable announcement and toast notification deck where new alerts rise in while older items scale down and recede with spring physics.
|
|
15
|
+
|
|
16
|
+
Synthesized from the canonical [transitions.dev](https://github.com/Jakubantalik/transitions.dev) interaction patterns. When notifications overlap, the stack maintains legibility while acknowledging queue depth. Hovering fans the stack into an interactive list.
|
|
17
|
+
|
|
18
|
+
## Install
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
# Install via motion-ui skill CLI:
|
|
22
|
+
python scripts/install-component.py banner-stacking --dest ./src
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Dependencies
|
|
26
|
+
|
|
27
|
+
- `clsx`
|
|
28
|
+
- `motion`
|
|
29
|
+
- `react`
|
|
30
|
+
- `tailwind-merge`
|
|
31
|
+
|
|
32
|
+
## Usage
|
|
33
|
+
|
|
34
|
+
```tsx
|
|
35
|
+
"use client";
|
|
36
|
+
|
|
37
|
+
import { useState } from "react";
|
|
38
|
+
import { BannerStacking, type BannerItem } from "@/components/motion/banner-stacking";
|
|
39
|
+
|
|
40
|
+
export function BannerStackingDemo() {
|
|
41
|
+
const [banners, setBanners] = useState<BannerItem[]>([
|
|
42
|
+
{ id: "1", title: "Deployment successful", description: "Production environment updated to v2.4.0", timestamp: "Just now", variant: "success" },
|
|
43
|
+
{ id: "2", title: "High memory utilization", description: "Node pool reaching 85% threshold", timestamp: "2m ago", variant: "warning" },
|
|
44
|
+
{ id: "3", title: "New collaborator added", description: "Sarah joined the workspace", timestamp: "5m ago" },
|
|
45
|
+
]);
|
|
46
|
+
|
|
47
|
+
return (
|
|
48
|
+
<div className="flex items-center justify-center p-8">
|
|
49
|
+
<BannerStacking
|
|
50
|
+
banners={banners}
|
|
51
|
+
onDismiss={(id) => setBanners((prev) => prev.filter((b) => b.id !== id))}
|
|
52
|
+
/>
|
|
53
|
+
</div>
|
|
54
|
+
);
|
|
55
|
+
}
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
## API Reference
|
|
59
|
+
|
|
60
|
+
### BannerStacking
|
|
61
|
+
|
|
62
|
+
| Prop | Type | Default | Required | Description |
|
|
63
|
+
| :--- | :--- | :--- | :--- | :--- |
|
|
64
|
+
| `banners` | `BannerItem[]` | — | Yes | Array of banner items to display in the stack |
|
|
65
|
+
| `onDismiss` | `(id: string) => void` | — | No | Callback fired when a banner dismissal button is pressed |
|
|
66
|
+
| `maxVisible` | `number` | `3` | No | Maximum number of visible stacked items before truncation |
|
|
67
|
+
| `className` | `string` | — | No | Additional CSS classes for root container |
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: "Delete with Smoky Dissolve"
|
|
3
|
+
description: "Interactive delete button trigger that disintegrates its target element into dissolving smoke particles and embers upon confirmation."
|
|
4
|
+
category: "Motion"
|
|
5
|
+
publishedAt: "2026-10-21"
|
|
6
|
+
updatedAt: "2026-10-21"
|
|
7
|
+
documentation: "references/motion/delete-with-smoky-dissolve.md"
|
|
8
|
+
markdown: "references/motion/delete-with-smoky-dissolve.md"
|
|
9
|
+
license: "MIT"
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# Delete with Smoky Dissolve
|
|
13
|
+
|
|
14
|
+
> Interactive delete button trigger that disintegrates its target element into dissolving smoke particles and embers upon confirmation.
|
|
15
|
+
|
|
16
|
+
Based on the canonical pattern from [transitions.dev](https://github.com/Jakubantalik/transitions.dev). Instead of an abrupt element removal or standard fade out, the target card disperses into rising smoke and ash particles before collapsing its footprint.
|
|
17
|
+
|
|
18
|
+
## Install
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
# Install via motion-ui skill CLI:
|
|
22
|
+
python scripts/install-component.py delete-with-smoky-dissolve --dest ./src
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Dependencies
|
|
26
|
+
|
|
27
|
+
- `clsx`
|
|
28
|
+
- `motion`
|
|
29
|
+
- `react`
|
|
30
|
+
- `tailwind-merge`
|
|
31
|
+
|
|
32
|
+
## Usage
|
|
33
|
+
|
|
34
|
+
```tsx
|
|
35
|
+
"use client";
|
|
36
|
+
|
|
37
|
+
import { DeleteWithSmokyDissolve } from "@/components/motion/delete-with-smoky-dissolve";
|
|
38
|
+
|
|
39
|
+
export function DeleteWithSmokyDissolveDemo() {
|
|
40
|
+
return (
|
|
41
|
+
<div className="flex items-center justify-center p-8">
|
|
42
|
+
<DeleteWithSmokyDissolve
|
|
43
|
+
itemTitle="Contract_2026_Final.pdf"
|
|
44
|
+
onDelete={() => console.log("Item deleted")}
|
|
45
|
+
/>
|
|
46
|
+
</div>
|
|
47
|
+
);
|
|
48
|
+
}
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
## API Reference
|
|
52
|
+
|
|
53
|
+
### DeleteWithSmokyDissolve
|
|
54
|
+
|
|
55
|
+
| Prop | Type | Default | Required | Description |
|
|
56
|
+
| :--- | :--- | :--- | :--- | :--- |
|
|
57
|
+
| `label` | `string` | `"Delete Item"` | No | Action trigger button label |
|
|
58
|
+
| `itemTitle` | `string` | `"Project Invoice #1042"` | No | Title of the targeted document or record |
|
|
59
|
+
| `onDelete` | `() => void` | — | No | Callback invoked after the smoke particle dissolution completes |
|
|
60
|
+
| `className` | `string` | — | No | Additional CSS classes for root container |
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: "Donut Chart"
|
|
3
|
+
description: "Animated SVG donut chart whose segments have rounded corners, consistent gaps, and smoothly tween from old values to new values when data changes."
|
|
4
|
+
category: "Motion"
|
|
5
|
+
publishedAt: "2026-10-21"
|
|
6
|
+
updatedAt: "2026-10-21"
|
|
7
|
+
documentation: "references/motion/donut-chart.md"
|
|
8
|
+
markdown: "references/motion/donut-chart.md"
|
|
9
|
+
license: "MIT"
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# Donut Chart
|
|
13
|
+
|
|
14
|
+
> Animated SVG donut chart whose segments have rounded corners, consistent gaps, and smoothly tween from old values to new values when data changes.
|
|
15
|
+
|
|
16
|
+
Morphing ring chart pattern from [transitions.dev](https://github.com/Jakubantalik/transitions.dev). Uses rounded stroke segments with gap offsets, smoothly adapting arc lengths when filtering by date or category without full chart re-renders.
|
|
17
|
+
|
|
18
|
+
## Install
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
# Install via motion-ui skill CLI:
|
|
22
|
+
python scripts/install-component.py donut-chart --dest ./src
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Dependencies
|
|
26
|
+
|
|
27
|
+
- `clsx`
|
|
28
|
+
- `motion`
|
|
29
|
+
- `react`
|
|
30
|
+
- `tailwind-merge`
|
|
31
|
+
|
|
32
|
+
## Usage
|
|
33
|
+
|
|
34
|
+
```tsx
|
|
35
|
+
"use client";
|
|
36
|
+
|
|
37
|
+
import { useState } from "react";
|
|
38
|
+
import { DonutChart, type DonutSegment } from "@/components/motion/donut-chart";
|
|
39
|
+
|
|
40
|
+
export function DonutChartDemo() {
|
|
41
|
+
const [data, setData] = useState<DonutSegment[]>([
|
|
42
|
+
{ id: "direct", label: "Direct", value: 50, color: "#6366f1" },
|
|
43
|
+
{ id: "organic", label: "Organic", value: 35, color: "#10b981" },
|
|
44
|
+
{ id: "referral", label: "Referral", value: 15, color: "#f59e0b" },
|
|
45
|
+
]);
|
|
46
|
+
|
|
47
|
+
return (
|
|
48
|
+
<div className="flex flex-col items-center gap-4 p-8">
|
|
49
|
+
<DonutChart data={data} centerValue="$14,250" centerLabel="MRR" />
|
|
50
|
+
<button
|
|
51
|
+
type="button"
|
|
52
|
+
onClick={() =>
|
|
53
|
+
setData([
|
|
54
|
+
{ id: "direct", label: "Direct", value: 25, color: "#6366f1" },
|
|
55
|
+
{ id: "organic", label: "Organic", value: 45, color: "#10b981" },
|
|
56
|
+
{ id: "referral", label: "Referral", value: 30, color: "#f59e0b" },
|
|
57
|
+
])
|
|
58
|
+
}
|
|
59
|
+
className="px-3 py-1.5 text-xs font-semibold rounded-lg bg-neutral-100 dark:bg-neutral-800"
|
|
60
|
+
>
|
|
61
|
+
Shuffle Shares
|
|
62
|
+
</button>
|
|
63
|
+
</div>
|
|
64
|
+
);
|
|
65
|
+
}
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
## API Reference
|
|
69
|
+
|
|
70
|
+
### DonutChart
|
|
71
|
+
|
|
72
|
+
| Prop | Type | Default | Required | Description |
|
|
73
|
+
| :--- | :--- | :--- | :--- | :--- |
|
|
74
|
+
| `data` | `DonutSegment[]` | Default platform breakdown | No | Array of segments with `id`, `label`, `value`, and `color` |
|
|
75
|
+
| `size` | `number` | `180` | No | Bounding square dimension in pixels |
|
|
76
|
+
| `thickness` | `number` | `18` | No | Ring thickness width in pixels |
|
|
77
|
+
| `centerLabel` | `string` | `"Total"` | No | Secondary caption under center value |
|
|
78
|
+
| `centerValue` | `string` | `"100%"` | No | Primary center KPI string |
|
|
79
|
+
| `className` | `string` | — | No | Additional CSS classes |
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: "Drag Drop with Physics"
|
|
3
|
+
description: "Physics-based drag-and-drop card surface with rotational inertia, velocity preservation, and magnetic slot snapping."
|
|
4
|
+
category: "Motion"
|
|
5
|
+
publishedAt: "2026-10-21"
|
|
6
|
+
updatedAt: "2026-10-21"
|
|
7
|
+
documentation: "references/motion/drag-drop-with-physics.md"
|
|
8
|
+
markdown: "references/motion/drag-drop-with-physics.md"
|
|
9
|
+
license: "MIT"
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# Drag Drop with Physics
|
|
13
|
+
|
|
14
|
+
> Physics-based drag-and-drop card surface with rotational inertia, velocity preservation, and magnetic slot snapping.
|
|
15
|
+
|
|
16
|
+
Synthesized from the interaction patterns in [transitions.dev](https://github.com/Jakubantalik/transitions.dev). Unlike rigid standard drag implementations, this component uses angular tilt proportional to lateral velocity and spring settling on release.
|
|
17
|
+
|
|
18
|
+
## Install
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
# Install via motion-ui skill CLI:
|
|
22
|
+
python scripts/install-component.py drag-drop-with-physics --dest ./src
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Dependencies
|
|
26
|
+
|
|
27
|
+
- `clsx`
|
|
28
|
+
- `motion`
|
|
29
|
+
- `react`
|
|
30
|
+
- `tailwind-merge`
|
|
31
|
+
|
|
32
|
+
## Usage
|
|
33
|
+
|
|
34
|
+
```tsx
|
|
35
|
+
"use client";
|
|
36
|
+
|
|
37
|
+
import { DragDropWithPhysics } from "@/components/motion/drag-drop-with-physics";
|
|
38
|
+
|
|
39
|
+
export function DragDropWithPhysicsDemo() {
|
|
40
|
+
return (
|
|
41
|
+
<div className="flex items-center justify-center p-8">
|
|
42
|
+
<DragDropWithPhysics
|
|
43
|
+
title="Implement View Transitions"
|
|
44
|
+
category="Frontend"
|
|
45
|
+
onDropInZone={(zone) => console.log("Dropped into zone:", zone)}
|
|
46
|
+
/>
|
|
47
|
+
</div>
|
|
48
|
+
);
|
|
49
|
+
}
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
## API Reference
|
|
53
|
+
|
|
54
|
+
### DragDropWithPhysics
|
|
55
|
+
|
|
56
|
+
| Prop | Type | Default | Required | Description |
|
|
57
|
+
| :--- | :--- | :--- | :--- | :--- |
|
|
58
|
+
| `title` | `string` | `"Design System Refactor"` | No | Card header label |
|
|
59
|
+
| `category` | `string` | `"Engineering"` | No | Pill tag shown on top-left of card |
|
|
60
|
+
| `onDropInZone` | `(zoneId: string) => void` | — | No | Callback fired when item crosses threshold into target |
|
|
61
|
+
| `className` | `string` | — | No | Additional CSS classes for root container |
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: "Dropdown Menu Morph"
|
|
3
|
+
description: "Fluid navigation menu dropdown whose container geometry, background sheet, and arrow tip morph seamlessly between submenu tabs."
|
|
4
|
+
category: "Motion"
|
|
5
|
+
publishedAt: "2026-10-21"
|
|
6
|
+
updatedAt: "2026-10-21"
|
|
7
|
+
documentation: "references/motion/dropdown-menu-morph.md"
|
|
8
|
+
markdown: "references/motion/dropdown-menu-morph.md"
|
|
9
|
+
license: "MIT"
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# Dropdown Menu Morph
|
|
13
|
+
|
|
14
|
+
> Fluid navigation menu dropdown whose container geometry, background sheet, and arrow tip morph seamlessly between submenu tabs.
|
|
15
|
+
|
|
16
|
+
The canonical Stripe and [transitions.dev](https://github.com/Jakubantalik/transitions.dev) fluid dropdown pattern. The floating card container smoothly resizes its bounding box as the user hovers across top-level navigation items rather than closing and reopening separate menus.
|
|
17
|
+
|
|
18
|
+
## Install
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
# Install via motion-ui skill CLI:
|
|
22
|
+
python scripts/install-component.py dropdown-menu-morph --dest ./src
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Dependencies
|
|
26
|
+
|
|
27
|
+
- `clsx`
|
|
28
|
+
- `motion`
|
|
29
|
+
- `react`
|
|
30
|
+
- `tailwind-merge`
|
|
31
|
+
|
|
32
|
+
## Usage
|
|
33
|
+
|
|
34
|
+
```tsx
|
|
35
|
+
"use client";
|
|
36
|
+
|
|
37
|
+
import { DropdownMenuMorph } from "@/components/motion/dropdown-menu-morph";
|
|
38
|
+
|
|
39
|
+
export function DropdownMenuMorphDemo() {
|
|
40
|
+
return (
|
|
41
|
+
<div className="flex items-center justify-center p-12 min-h-[300px]">
|
|
42
|
+
<DropdownMenuMorph />
|
|
43
|
+
</div>
|
|
44
|
+
);
|
|
45
|
+
}
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
## API Reference
|
|
49
|
+
|
|
50
|
+
### DropdownMenuMorph
|
|
51
|
+
|
|
52
|
+
| Prop | Type | Default | Required | Description |
|
|
53
|
+
| :--- | :--- | :--- | :--- | :--- |
|
|
54
|
+
| `tabs` | `NavTabItem[]` | Default platform tabs | No | Array of tabs containing `id`, `label`, and dropdown `content` |
|
|
55
|
+
| `className` | `string` | — | No | Additional CSS classes for root container |
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: "Get Pro Button"
|
|
3
|
+
description: "High-converting Pro upgrade trigger featuring an animated conic gradient border, ambient chromatic glow, and specular hover sheen."
|
|
4
|
+
category: "Motion"
|
|
5
|
+
publishedAt: "2026-10-21"
|
|
6
|
+
updatedAt: "2026-10-21"
|
|
7
|
+
documentation: "references/motion/get-pro-button.md"
|
|
8
|
+
markdown: "references/motion/get-pro-button.md"
|
|
9
|
+
license: "MIT"
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# Get Pro Button
|
|
13
|
+
|
|
14
|
+
> High-converting Pro upgrade trigger featuring an animated conic gradient border, ambient chromatic glow, and specular hover sheen.
|
|
15
|
+
|
|
16
|
+
Pattern from [transitions.dev](https://github.com/Jakubantalik/transitions.dev). High-emphasis call to action button with multi-color radial gradient halo and sweeping highlight sheen.
|
|
17
|
+
|
|
18
|
+
## Install
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
# Install via motion-ui skill CLI:
|
|
22
|
+
python scripts/install-component.py get-pro-button --dest ./src
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Dependencies
|
|
26
|
+
|
|
27
|
+
- `clsx`
|
|
28
|
+
- `motion`
|
|
29
|
+
- `react`
|
|
30
|
+
- `tailwind-merge`
|
|
31
|
+
|
|
32
|
+
## Usage
|
|
33
|
+
|
|
34
|
+
```tsx
|
|
35
|
+
"use client";
|
|
36
|
+
|
|
37
|
+
import { GetProButton } from "@/components/motion/get-pro-button";
|
|
38
|
+
|
|
39
|
+
export function GetProButtonDemo() {
|
|
40
|
+
return (
|
|
41
|
+
<div className="flex items-center justify-center p-8">
|
|
42
|
+
<GetProButton>Unlock All Features</GetProButton>
|
|
43
|
+
</div>
|
|
44
|
+
);
|
|
45
|
+
}
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
## API Reference
|
|
49
|
+
|
|
50
|
+
### GetProButton
|
|
51
|
+
|
|
52
|
+
| Prop | Type | Default | Required | Description |
|
|
53
|
+
| :--- | :--- | :--- | :--- | :--- |
|
|
54
|
+
| `children` | `React.ReactNode` | `"Upgrade to Pro"` | No | Button label content |
|
|
55
|
+
| `glow` | `boolean` | `true` | No | Enables chromatic blur glow behind button |
|
|
56
|
+
| `className` | `string` | — | No | Additional CSS classes |
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: "Image Open Tilt"
|
|
3
|
+
description: "Interactive media lightbox trigger opening an image preview with 3D perspective tilt, depth parallax, and zero layout shift."
|
|
4
|
+
category: "Motion"
|
|
5
|
+
publishedAt: "2026-10-21"
|
|
6
|
+
updatedAt: "2026-10-21"
|
|
7
|
+
documentation: "references/motion/image-open-tilt.md"
|
|
8
|
+
markdown: "references/motion/image-open-tilt.md"
|
|
9
|
+
license: "MIT"
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# Image Open Tilt
|
|
13
|
+
|
|
14
|
+
> Interactive media lightbox trigger opening an image preview with 3D perspective tilt, depth parallax, and zero layout shift.
|
|
15
|
+
|
|
16
|
+
Canonical lightbox transition from [transitions.dev](https://github.com/Jakubantalik/transitions.dev). Uses 3D transform perspective with initial rotational pitch on entrance that settles squarely onto the screen.
|
|
17
|
+
|
|
18
|
+
## Install
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
# Install via motion-ui skill CLI:
|
|
22
|
+
python scripts/install-component.py image-open-tilt --dest ./src
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Dependencies
|
|
26
|
+
|
|
27
|
+
- `clsx`
|
|
28
|
+
- `motion`
|
|
29
|
+
- `react`
|
|
30
|
+
- `tailwind-merge`
|
|
31
|
+
|
|
32
|
+
## Usage
|
|
33
|
+
|
|
34
|
+
```tsx
|
|
35
|
+
"use client";
|
|
36
|
+
|
|
37
|
+
import { ImageOpenTilt } from "@/components/motion/image-open-tilt";
|
|
38
|
+
|
|
39
|
+
export function ImageOpenTiltDemo() {
|
|
40
|
+
return (
|
|
41
|
+
<div className="flex items-center justify-center p-8">
|
|
42
|
+
<ImageOpenTilt
|
|
43
|
+
title="Modernist Pavilion"
|
|
44
|
+
src="https://images.unsplash.com/photo-1618005182384-a83a8bd57fbe?auto=format&fit=crop&w=800&q=80"
|
|
45
|
+
/>
|
|
46
|
+
</div>
|
|
47
|
+
);
|
|
48
|
+
}
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
## API Reference
|
|
52
|
+
|
|
53
|
+
### ImageOpenTilt
|
|
54
|
+
|
|
55
|
+
| Prop | Type | Default | Required | Description |
|
|
56
|
+
| :--- | :--- | :--- | :--- | :--- |
|
|
57
|
+
| `src` | `string` | Unsplash abstract photo | No | URL of the image asset |
|
|
58
|
+
| `alt` | `string` | `"Abstract architectural forms"` | No | Alt text description |
|
|
59
|
+
| `title` | `string` | `"Parametric Structure"` | No | Overlay title |
|
|
60
|
+
| `className` | `string` | — | No | Additional CSS classes |
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: "Input Clear with Dissolve"
|
|
3
|
+
description: "Form input with animated character dissolve dissipation effect that scatters letters with particle blur when clearing."
|
|
4
|
+
category: "Motion"
|
|
5
|
+
publishedAt: "2026-10-21"
|
|
6
|
+
updatedAt: "2026-10-21"
|
|
7
|
+
documentation: "references/motion/input-clear-with-dissolve.md"
|
|
8
|
+
markdown: "references/motion/input-clear-with-dissolve.md"
|
|
9
|
+
license: "MIT"
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# Input Clear with Dissolve
|
|
13
|
+
|
|
14
|
+
> Form input with animated character dissolve dissipation effect that scatters letters with particle blur when clearing.
|
|
15
|
+
|
|
16
|
+
Transition pattern from [transitions.dev](https://github.com/Jakubantalik/transitions.dev). When the user clicks the clear button, characters don't disappear instantaneously; instead, individual letter spans stagger, float upward, and blur out like dispersing vapor.
|
|
17
|
+
|
|
18
|
+
## Install
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
# Install via motion-ui skill CLI:
|
|
22
|
+
python scripts/install-component.py input-clear-with-dissolve --dest ./src
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Dependencies
|
|
26
|
+
|
|
27
|
+
- `clsx`
|
|
28
|
+
- `motion`
|
|
29
|
+
- `react`
|
|
30
|
+
- `tailwind-merge`
|
|
31
|
+
|
|
32
|
+
## Usage
|
|
33
|
+
|
|
34
|
+
```tsx
|
|
35
|
+
"use client";
|
|
36
|
+
|
|
37
|
+
import { InputClearWithDissolve } from "@/components/motion/input-clear-with-dissolve";
|
|
38
|
+
|
|
39
|
+
export function InputClearWithDissolveDemo() {
|
|
40
|
+
return (
|
|
41
|
+
<div className="flex items-center justify-center p-8">
|
|
42
|
+
<InputClearWithDissolve defaultValue="Dynamic Motion Primitives" />
|
|
43
|
+
</div>
|
|
44
|
+
);
|
|
45
|
+
}
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
## API Reference
|
|
49
|
+
|
|
50
|
+
### InputClearWithDissolve
|
|
51
|
+
|
|
52
|
+
| Prop | Type | Default | Required | Description |
|
|
53
|
+
| :--- | :--- | :--- | :--- | :--- |
|
|
54
|
+
| `value` | `string` | — | No | Controlled input value |
|
|
55
|
+
| `defaultValue` | `string` | `"search query"` | No | Uncontrolled default initial value |
|
|
56
|
+
| `onValueChange` | `(val: string) => void` | — | No | Fired on input value changes |
|
|
57
|
+
| `placeholder` | `string` | `"Type something..."` | No | HTML input placeholder |
|
|
58
|
+
| `className` | `string` | — | No | Additional CSS classes |
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: "Learn More Hover"
|
|
3
|
+
description: "Editorial action link with continuous arrow loop trail, underline reveal, and spring overshoot trajectory on hover."
|
|
4
|
+
category: "Motion"
|
|
5
|
+
publishedAt: "2026-10-21"
|
|
6
|
+
updatedAt: "2026-10-21"
|
|
7
|
+
documentation: "references/motion/learn-more-hover.md"
|
|
8
|
+
markdown: "references/motion/learn-more-hover.md"
|
|
9
|
+
license: "MIT"
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# Learn More Hover
|
|
13
|
+
|
|
14
|
+
> Editorial action link with continuous arrow loop trail, underline reveal, and spring overshoot trajectory on hover.
|
|
15
|
+
|
|
16
|
+
Micro-interaction from [transitions.dev](https://github.com/Jakubantalik/transitions.dev). On hover, the arrow icon flies out the right edge and re-enters smoothly from the left while the underline expands across the text width.
|
|
17
|
+
|
|
18
|
+
## Install
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
# Install via motion-ui skill CLI:
|
|
22
|
+
python scripts/install-component.py learn-more-hover --dest ./src
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Dependencies
|
|
26
|
+
|
|
27
|
+
- `clsx`
|
|
28
|
+
- `motion`
|
|
29
|
+
- `react`
|
|
30
|
+
- `tailwind-merge`
|
|
31
|
+
|
|
32
|
+
## Usage
|
|
33
|
+
|
|
34
|
+
```tsx
|
|
35
|
+
"use client";
|
|
36
|
+
|
|
37
|
+
import { LearnMoreHover } from "@/components/motion/learn-more-hover";
|
|
38
|
+
|
|
39
|
+
export function LearnMoreHoverDemo() {
|
|
40
|
+
return (
|
|
41
|
+
<div className="flex items-center justify-center p-8">
|
|
42
|
+
<LearnMoreHover label="Read Architecture Guide" href="/guides" />
|
|
43
|
+
</div>
|
|
44
|
+
);
|
|
45
|
+
}
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
## API Reference
|
|
49
|
+
|
|
50
|
+
### LearnMoreHover
|
|
51
|
+
|
|
52
|
+
| Prop | Type | Default | Required | Description |
|
|
53
|
+
| :--- | :--- | :--- | :--- | :--- |
|
|
54
|
+
| `label` | `string` | `"Explore Documentation"` | No | Action link text |
|
|
55
|
+
| `href` | `string` | `"#"` | No | Destination URL |
|
|
56
|
+
| `className` | `string` | — | No | Additional CSS classes |
|