motion-ui-skill 2.0.0 → 2.1.1

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.
Files changed (166) hide show
  1. package/README.md +71 -21
  2. package/SKILL.md +83 -9
  3. package/bin/index.mjs +2 -2
  4. package/bin/installer.mjs +6 -0
  5. package/catalog.json +1044 -139
  6. package/components/agents/thinking-states.tsx +156 -0
  7. package/components/buttons/aqua-button.tsx +145 -0
  8. package/components/buttons/ash-burst-button.tsx +528 -0
  9. package/components/buttons/brutal-button.tsx +68 -0
  10. package/components/buttons/chrome-button.tsx +444 -0
  11. package/components/buttons/click-powerup.tsx +203 -0
  12. package/components/buttons/command-button.tsx +226 -0
  13. package/components/buttons/confetti-button.tsx +132 -0
  14. package/components/buttons/cooldown-button.tsx +169 -0
  15. package/components/buttons/demonic-button.tsx +470 -0
  16. package/components/buttons/dither-button.tsx +192 -0
  17. package/components/buttons/doubt-button.tsx +240 -0
  18. package/components/buttons/evil-eye-button.tsx +563 -0
  19. package/components/buttons/frame-button.tsx +211 -0
  20. package/components/buttons/glitch-button.tsx +243 -0
  21. package/components/buttons/highlight-button.tsx +196 -0
  22. package/components/buttons/hold-button.tsx +245 -0
  23. package/components/buttons/minecraft-button.tsx +651 -0
  24. package/components/buttons/minimal-button.tsx +50 -0
  25. package/components/buttons/morph-status-button.tsx +264 -0
  26. package/components/buttons/movie-pass-button.tsx +205 -0
  27. package/components/buttons/realistic-switch.tsx +298 -0
  28. package/components/buttons/reveal-button.tsx +197 -0
  29. package/components/buttons/shiny-button.tsx +87 -0
  30. package/components/buttons/slide-to-detonate.tsx +444 -0
  31. package/components/buttons/sticky-button.tsx +184 -0
  32. package/components/buttons/thruster-button.tsx +920 -0
  33. package/components/buttons/troll-button.tsx +264 -0
  34. package/components/motion/banner-stacking.tsx +124 -0
  35. package/components/motion/delete-with-smoky-dissolve.tsx +145 -0
  36. package/components/motion/donut-chart.tsx +112 -0
  37. package/components/motion/drag-drop-with-physics.tsx +116 -0
  38. package/components/motion/dropdown-menu-morph.tsx +157 -0
  39. package/components/motion/get-pro-button.tsx +54 -0
  40. package/components/motion/image-open-tilt.tsx +79 -0
  41. package/components/motion/input-clear-with-dissolve.tsx +111 -0
  42. package/components/motion/learn-more-hover.tsx +71 -0
  43. package/components/motion/matrix-dot-loader.tsx +68 -0
  44. package/components/motion/organic-shimmer.tsx +49 -0
  45. package/components/motion/pro-gradient-text.tsx +46 -0
  46. package/components/motion/skeleton-loader-and-reveal.tsx +81 -0
  47. package/components/motion/spinner-to-check-morph.tsx +99 -0
  48. package/components/motion/spinning-counter.tsx +64 -0
  49. package/components/motion/text-morph.tsx +80 -0
  50. package/components/motion/texts-reveal.tsx +49 -0
  51. package/data/app-interface.csv +33 -0
  52. package/data/charts.csv +26 -0
  53. package/data/colors.csv +193 -0
  54. package/data/google-fonts.csv +1935 -0
  55. package/data/icons.csv +106 -0
  56. package/data/landing.csv +35 -0
  57. package/data/motion.csv +18 -0
  58. package/data/products.csv +193 -0
  59. package/data/react-performance.csv +45 -0
  60. package/data/stacks/angular.csv +51 -0
  61. package/data/stacks/astro.csv +54 -0
  62. package/data/stacks/avalonia.csv +57 -0
  63. package/data/stacks/flutter.csv +53 -0
  64. package/data/stacks/html-tailwind.csv +60 -0
  65. package/data/stacks/javafx.csv +76 -0
  66. package/data/stacks/jetpack-compose.csv +53 -0
  67. package/data/stacks/laravel.csv +51 -0
  68. package/data/stacks/nextjs.csv +62 -0
  69. package/data/stacks/nuxt-ui.csv +77 -0
  70. package/data/stacks/nuxtjs.csv +68 -0
  71. package/data/stacks/react-native.csv +52 -0
  72. package/data/stacks/react.csv +67 -0
  73. package/data/stacks/shadcn.csv +69 -0
  74. package/data/stacks/svelte.csv +56 -0
  75. package/data/stacks/swiftui.csv +51 -0
  76. package/data/stacks/threejs.csv +54 -0
  77. package/data/stacks/uno.csv +60 -0
  78. package/data/stacks/uwp.csv +56 -0
  79. package/data/stacks/vue.csv +50 -0
  80. package/data/stacks/winui.csv +60 -0
  81. package/data/stacks/wpf.csv +57 -0
  82. package/data/styles.csv +89 -0
  83. package/data/typography.csv +75 -0
  84. package/data/ui-reasoning.csv +193 -0
  85. package/data/ux-guidelines.csv +120 -0
  86. package/evals/catalog_eval.py +56 -0
  87. package/icons/annotations/loop-arrow.tsx +61 -0
  88. package/icons/brands/anthropic.tsx +26 -0
  89. package/icons/brands/apple.tsx +26 -0
  90. package/icons/brands/canva.tsx +26 -0
  91. package/icons/brands/claude-ai.tsx +26 -0
  92. package/icons/brands/discord.tsx +26 -0
  93. package/icons/brands/github.tsx +26 -0
  94. package/icons/brands/gmail.tsx +26 -0
  95. package/icons/brands/google.tsx +26 -0
  96. package/icons/brands/linkedin.tsx +29 -0
  97. package/icons/brands/microsoft.tsx +26 -0
  98. package/icons/brands/next-js.tsx +26 -0
  99. package/icons/brands/producthunt.tsx +26 -0
  100. package/icons/brands/react-js.tsx +29 -0
  101. package/icons/brands/shadcn-ui.tsx +26 -0
  102. package/icons/brands/tailwind-css.tsx +26 -0
  103. package/icons/brands/twitter.tsx +30 -0
  104. package/icons/brands/typescript.tsx +26 -0
  105. package/icons/brands/unsplash.tsx +27 -0
  106. package/icons/brands/vercel.tsx +26 -0
  107. package/icons/brands/whatsapp.tsx +26 -0
  108. package/package.json +9 -3
  109. package/prompts/install-motion-ui.md +17 -0
  110. package/references/agents/thinking-states.md +56 -0
  111. package/references/craft/aqua-button.md +53 -0
  112. package/references/craft/ash-burst-button.md +55 -0
  113. package/references/craft/brutal-button.md +52 -0
  114. package/references/craft/chrome-button.md +53 -0
  115. package/references/craft/click-powerup.md +53 -0
  116. package/references/craft/command-button.md +53 -0
  117. package/references/craft/confetti-button.md +54 -0
  118. package/references/craft/cooldown-button.md +54 -0
  119. package/references/craft/demonic-button.md +53 -0
  120. package/references/craft/dither-button.md +52 -0
  121. package/references/craft/doubt-button.md +53 -0
  122. package/references/craft/evil-eye-button.md +52 -0
  123. package/references/craft/frame-button.md +54 -0
  124. package/references/craft/glitch-button.md +52 -0
  125. package/references/craft/highlight-button.md +53 -0
  126. package/references/craft/hold-button.md +53 -0
  127. package/references/craft/minecraft-button.md +53 -0
  128. package/references/craft/minimal-button.md +52 -0
  129. package/references/craft/morph-status-button.md +53 -0
  130. package/references/craft/movie-pass-button.md +53 -0
  131. package/references/craft/realistic-switch.md +54 -0
  132. package/references/craft/reveal-button.md +53 -0
  133. package/references/craft/shiny-button.md +52 -0
  134. package/references/craft/slide-to-detonate.md +53 -0
  135. package/references/craft/sticky-button.md +54 -0
  136. package/references/craft/thruster-button.md +53 -0
  137. package/references/craft/troll-button.md +54 -0
  138. package/references/guides/design-intelligence.md +125 -0
  139. package/references/guides/interaction-transitions.md +56 -38
  140. package/references/guides/motion-polish-rules.md +75 -0
  141. package/references/guides/stack-best-practices.md +38 -0
  142. package/references/motion/banner-stacking.md +67 -0
  143. package/references/motion/delete-with-smoky-dissolve.md +60 -0
  144. package/references/motion/donut-chart.md +79 -0
  145. package/references/motion/drag-drop-with-physics.md +61 -0
  146. package/references/motion/dropdown-menu-morph.md +55 -0
  147. package/references/motion/get-pro-button.md +56 -0
  148. package/references/motion/image-open-tilt.md +60 -0
  149. package/references/motion/input-clear-with-dissolve.md +58 -0
  150. package/references/motion/learn-more-hover.md +56 -0
  151. package/references/motion/matrix-dot-loader.md +58 -0
  152. package/references/motion/organic-shimmer.md +63 -0
  153. package/references/motion/pro-gradient-text.md +57 -0
  154. package/references/motion/skeleton-loader-and-reveal.md +67 -0
  155. package/references/motion/spinner-to-check-morph.md +67 -0
  156. package/references/motion/spinning-counter.md +74 -0
  157. package/references/motion/text-morph.md +64 -0
  158. package/references/motion/texts-reveal.md +56 -0
  159. package/scripts/build_docs.py +39 -4
  160. package/scripts/core.py +993 -0
  161. package/scripts/design_system.py +1668 -0
  162. package/scripts/reasoning_contract.py +123 -0
  163. package/scripts/search.py +177 -0
  164. package/scripts/test_release.py +12 -0
  165. package/scripts/verify_skill.py +4 -4
  166. package/test/test_installer.mjs +133 -0
@@ -0,0 +1,54 @@
1
+ ---
2
+ title: "Cooldown Button"
3
+ description: "Button that locks itself behind a draining radial timer after each click to prevent spam and double submits."
4
+ category: "Components"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/craft/cooldown-button.md"
8
+ markdown: "references/craft/cooldown-button.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Cooldown Button
13
+
14
+ > Button that locks itself behind a draining radial timer after each click to prevent spam and double submits.
15
+
16
+ ## Install
17
+
18
+ ```bash
19
+ # Install via motion-ui skill CLI:
20
+ python scripts/install-component.py cooldown-button --dest ./src
21
+ ```
22
+
23
+ ## Dependencies
24
+
25
+ - `clsx`
26
+ - `motion`
27
+ - `react`
28
+ - `tailwind-merge`
29
+
30
+ ## Usage
31
+
32
+ ```tsx
33
+ "use client";
34
+
35
+ import { CooldownButton } from "@/components/buttons/cooldown-button";
36
+
37
+ export function CooldownButtonDemo() {
38
+ return (
39
+ <div className="flex items-center justify-center p-6">
40
+ <CooldownButton>Click Me</CooldownButton>
41
+ </div>
42
+ );
43
+ }
44
+ ```
45
+
46
+ ## API Reference
47
+
48
+ ### CooldownButton
49
+
50
+ | Prop | Type | Default | Required | Description |
51
+ | :--- | :--- | :--- | :--- | :--- |
52
+ | `cooldownMs` | `number` | 3000 | No | Duration of lockout in milliseconds |
53
+ | `className` | `string` | — | No | Additional CSS classes |
54
+ | `children` | `React.ReactNode` | — | No | Button label content |
@@ -0,0 +1,53 @@
1
+ ---
2
+ title: "Demonic Button"
3
+ description: "Hold-to-summon button that raises devil horns from behind while an interactive canvas fire builds into a roar."
4
+ category: "Components"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/craft/demonic-button.md"
8
+ markdown: "references/craft/demonic-button.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Demonic Button
13
+
14
+ > Hold-to-summon button that raises devil horns from behind while an interactive canvas fire builds into a roar.
15
+
16
+ ## Install
17
+
18
+ ```bash
19
+ # Install via motion-ui skill CLI:
20
+ python scripts/install-component.py demonic-button --dest ./src
21
+ ```
22
+
23
+ ## Dependencies
24
+
25
+ - `clsx`
26
+ - `react`
27
+ - `tailwind-merge`
28
+
29
+ ## Usage
30
+
31
+ ```tsx
32
+ "use client";
33
+
34
+ import { DemonicButton } from "@/components/buttons/demonic-button";
35
+
36
+ export function DemonicButtonDemo() {
37
+ return (
38
+ <div className="flex items-center justify-center p-6">
39
+ <DemonicButton>Click Me</DemonicButton>
40
+ </div>
41
+ );
42
+ }
43
+ ```
44
+
45
+ ## API Reference
46
+
47
+ ### DemonicButton
48
+
49
+ | Prop | Type | Default | Required | Description |
50
+ | :--- | :--- | :--- | :--- | :--- |
51
+ | `holdDurationMs` | `number` | 2000 | No | Required hold time to complete summon |
52
+ | `className` | `string` | — | No | Additional CSS classes |
53
+ | `children` | `React.ReactNode` | — | No | Button label content |
@@ -0,0 +1,52 @@
1
+ ---
2
+ title: "Dither Button"
3
+ description: "High-contrast button with an animated 4x4 ordered-dither wave background and knockout typography."
4
+ category: "Components"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/craft/dither-button.md"
8
+ markdown: "references/craft/dither-button.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Dither Button
13
+
14
+ > High-contrast button with an animated 4x4 ordered-dither wave background and knockout typography.
15
+
16
+ ## Install
17
+
18
+ ```bash
19
+ # Install via motion-ui skill CLI:
20
+ python scripts/install-component.py dither-button --dest ./src
21
+ ```
22
+
23
+ ## Dependencies
24
+
25
+ - `clsx`
26
+ - `react`
27
+ - `tailwind-merge`
28
+
29
+ ## Usage
30
+
31
+ ```tsx
32
+ "use client";
33
+
34
+ import { DitherButton } from "@/components/buttons/dither-button";
35
+
36
+ export function DitherButtonDemo() {
37
+ return (
38
+ <div className="flex items-center justify-center p-6">
39
+ <DitherButton>Click Me</DitherButton>
40
+ </div>
41
+ );
42
+ }
43
+ ```
44
+
45
+ ## API Reference
46
+
47
+ ### DitherButton
48
+
49
+ | Prop | Type | Default | Required | Description |
50
+ | :--- | :--- | :--- | :--- | :--- |
51
+ | `className` | `string` | — | No | Additional CSS classes |
52
+ | `children` | `React.ReactNode` | — | No | Button label content |
@@ -0,0 +1,53 @@
1
+ ---
2
+ title: "Doubt Button"
3
+ description: "Escalating-confirmation button that prompts the user through comical guilt-tripping steps before firing."
4
+ category: "Components"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/craft/doubt-button.md"
8
+ markdown: "references/craft/doubt-button.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Doubt Button
13
+
14
+ > Escalating-confirmation button that prompts the user through comical guilt-tripping steps before firing.
15
+
16
+ ## Install
17
+
18
+ ```bash
19
+ # Install via motion-ui skill CLI:
20
+ python scripts/install-component.py doubt-button --dest ./src
21
+ ```
22
+
23
+ ## Dependencies
24
+
25
+ - `clsx`
26
+ - `motion`
27
+ - `react`
28
+ - `tailwind-merge`
29
+
30
+ ## Usage
31
+
32
+ ```tsx
33
+ "use client";
34
+
35
+ import { DoubtButton } from "@/components/buttons/doubt-button";
36
+
37
+ export function DoubtButtonDemo() {
38
+ return (
39
+ <div className="flex items-center justify-center p-6">
40
+ <DoubtButton>Click Me</DoubtButton>
41
+ </div>
42
+ );
43
+ }
44
+ ```
45
+
46
+ ## API Reference
47
+
48
+ ### DoubtButton
49
+
50
+ | Prop | Type | Default | Required | Description |
51
+ | :--- | :--- | :--- | :--- | :--- |
52
+ | `onConfirmed` | `() => void` | — | No | Callback invoked once final doubt prompt is accepted |
53
+ | `className` | `string` | — | No | Additional CSS classes |
@@ -0,0 +1,52 @@
1
+ ---
2
+ title: "Evil Eye Button"
3
+ description: "Obsidian pill button with a burning eye behind the label that tracks cursor movement across the viewport."
4
+ category: "Components"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/craft/evil-eye-button.md"
8
+ markdown: "references/craft/evil-eye-button.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Evil Eye Button
13
+
14
+ > Obsidian pill button with a burning eye behind the label that tracks cursor movement across the viewport.
15
+
16
+ ## Install
17
+
18
+ ```bash
19
+ # Install via motion-ui skill CLI:
20
+ python scripts/install-component.py evil-eye-button --dest ./src
21
+ ```
22
+
23
+ ## Dependencies
24
+
25
+ - `clsx`
26
+ - `react`
27
+ - `tailwind-merge`
28
+
29
+ ## Usage
30
+
31
+ ```tsx
32
+ "use client";
33
+
34
+ import { EvilEyeButton } from "@/components/buttons/evil-eye-button";
35
+
36
+ export function EvilEyeButtonDemo() {
37
+ return (
38
+ <div className="flex items-center justify-center p-6">
39
+ <EvilEyeButton>Click Me</EvilEyeButton>
40
+ </div>
41
+ );
42
+ }
43
+ ```
44
+
45
+ ## API Reference
46
+
47
+ ### EvilEyeButton
48
+
49
+ | Prop | Type | Default | Required | Description |
50
+ | :--- | :--- | :--- | :--- | :--- |
51
+ | `className` | `string` | — | No | Additional CSS classes |
52
+ | `children` | `React.ReactNode` | — | No | Button label content |
@@ -0,0 +1,54 @@
1
+ ---
2
+ title: "Frame Button"
3
+ description: "Technical framed button with reticle crosshair corners, bracket accents, and ambient corner blooming on hover."
4
+ category: "Components"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/craft/frame-button.md"
8
+ markdown: "references/craft/frame-button.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Frame Button
13
+
14
+ > Technical framed button with reticle crosshair corners, bracket accents, and ambient corner blooming on hover.
15
+
16
+ ## Install
17
+
18
+ ```bash
19
+ # Install via motion-ui skill CLI:
20
+ python scripts/install-component.py frame-button --dest ./src
21
+ ```
22
+
23
+ ## Dependencies
24
+
25
+ - `clsx`
26
+ - `motion`
27
+ - `react`
28
+ - `tailwind-merge`
29
+
30
+ ## Usage
31
+
32
+ ```tsx
33
+ "use client";
34
+
35
+ import { FrameButton } from "@/components/buttons/frame-button";
36
+
37
+ export function FrameButtonDemo() {
38
+ return (
39
+ <div className="flex items-center justify-center p-6">
40
+ <FrameButton>Click Me</FrameButton>
41
+ </div>
42
+ );
43
+ }
44
+ ```
45
+
46
+ ## API Reference
47
+
48
+ ### FrameButton
49
+
50
+ | Prop | Type | Default | Required | Description |
51
+ | :--- | :--- | :--- | :--- | :--- |
52
+ | `glow` | `boolean` | false | No | Enable ambient bloom highlight |
53
+ | `className` | `string` | — | No | Additional CSS classes |
54
+ | `children` | `React.ReactNode` | — | No | Button label content |
@@ -0,0 +1,52 @@
1
+ ---
2
+ title: "Glitch Button"
3
+ description: "Cyberpunk button with chromatic aberration RGB splitting, scanline jitter, and glitch slices on hover."
4
+ category: "Components"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/craft/glitch-button.md"
8
+ markdown: "references/craft/glitch-button.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Glitch Button
13
+
14
+ > Cyberpunk button with chromatic aberration RGB splitting, scanline jitter, and glitch slices on hover.
15
+
16
+ ## Install
17
+
18
+ ```bash
19
+ # Install via motion-ui skill CLI:
20
+ python scripts/install-component.py glitch-button --dest ./src
21
+ ```
22
+
23
+ ## Dependencies
24
+
25
+ - `clsx`
26
+ - `react`
27
+ - `tailwind-merge`
28
+
29
+ ## Usage
30
+
31
+ ```tsx
32
+ "use client";
33
+
34
+ import { GlitchButton } from "@/components/buttons/glitch-button";
35
+
36
+ export function GlitchButtonDemo() {
37
+ return (
38
+ <div className="flex items-center justify-center p-6">
39
+ <GlitchButton>Click Me</GlitchButton>
40
+ </div>
41
+ );
42
+ }
43
+ ```
44
+
45
+ ## API Reference
46
+
47
+ ### GlitchButton
48
+
49
+ | Prop | Type | Default | Required | Description |
50
+ | :--- | :--- | :--- | :--- | :--- |
51
+ | `className` | `string` | — | No | Additional CSS classes |
52
+ | `children` | `React.ReactNode` | — | No | Button label content |
@@ -0,0 +1,53 @@
1
+ ---
2
+ title: "Highlight Button"
3
+ description: "Button with an ambient continuous border highlight tracing its perimeter smoothly on hover."
4
+ category: "Components"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/craft/highlight-button.md"
8
+ markdown: "references/craft/highlight-button.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Highlight Button
13
+
14
+ > Button with an ambient continuous border highlight tracing its perimeter smoothly on hover.
15
+
16
+ ## Install
17
+
18
+ ```bash
19
+ # Install via motion-ui skill CLI:
20
+ python scripts/install-component.py highlight-button --dest ./src
21
+ ```
22
+
23
+ ## Dependencies
24
+
25
+ - `clsx`
26
+ - `motion`
27
+ - `react`
28
+ - `tailwind-merge`
29
+
30
+ ## Usage
31
+
32
+ ```tsx
33
+ "use client";
34
+
35
+ import { HighlightButton } from "@/components/buttons/highlight-button";
36
+
37
+ export function HighlightButtonDemo() {
38
+ return (
39
+ <div className="flex items-center justify-center p-6">
40
+ <HighlightButton>Click Me</HighlightButton>
41
+ </div>
42
+ );
43
+ }
44
+ ```
45
+
46
+ ## API Reference
47
+
48
+ ### HighlightButton
49
+
50
+ | Prop | Type | Default | Required | Description |
51
+ | :--- | :--- | :--- | :--- | :--- |
52
+ | `className` | `string` | — | No | Additional CSS classes |
53
+ | `children` | `React.ReactNode` | — | No | Button label content |
@@ -0,0 +1,53 @@
1
+ ---
2
+ title: "Hold Button"
3
+ description: "Hold-to-confirm button whose inner fill grows smoothly from 0 to 100% with shake-to-abort feedback."
4
+ category: "Components"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/craft/hold-button.md"
8
+ markdown: "references/craft/hold-button.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Hold Button
13
+
14
+ > Hold-to-confirm button whose inner fill grows smoothly from 0 to 100% with shake-to-abort feedback.
15
+
16
+ ## Install
17
+
18
+ ```bash
19
+ # Install via motion-ui skill CLI:
20
+ python scripts/install-component.py hold-button --dest ./src
21
+ ```
22
+
23
+ ## Dependencies
24
+
25
+ - `clsx`
26
+ - `react`
27
+ - `tailwind-merge`
28
+
29
+ ## Usage
30
+
31
+ ```tsx
32
+ "use client";
33
+
34
+ import { HoldButton } from "@/components/buttons/hold-button";
35
+
36
+ export function HoldButtonDemo() {
37
+ return (
38
+ <div className="flex items-center justify-center p-6">
39
+ <HoldButton>Click Me</HoldButton>
40
+ </div>
41
+ );
42
+ }
43
+ ```
44
+
45
+ ## API Reference
46
+
47
+ ### HoldButton
48
+
49
+ | Prop | Type | Default | Required | Description |
50
+ | :--- | :--- | :--- | :--- | :--- |
51
+ | `durationMs` | `number` | 1500 | No | Required continuous press duration |
52
+ | `onComplete` | `() => void` | — | No | Triggered when hold fill reaches 100% |
53
+ | `className` | `string` | — | No | Additional CSS classes |
@@ -0,0 +1,53 @@
1
+ ---
2
+ title: "Minecraft Button"
3
+ description: "Pixel stone menu button that cracks upon repeated clicks, shatters into chips, and drops an item to respawn."
4
+ category: "Components"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/craft/minecraft-button.md"
8
+ markdown: "references/craft/minecraft-button.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Minecraft Button
13
+
14
+ > Pixel stone menu button that cracks upon repeated clicks, shatters into chips, and drops an item to respawn.
15
+
16
+ ## Install
17
+
18
+ ```bash
19
+ # Install via motion-ui skill CLI:
20
+ python scripts/install-component.py minecraft-button --dest ./src
21
+ ```
22
+
23
+ ## Dependencies
24
+
25
+ - `clsx`
26
+ - `react`
27
+ - `react-dom`
28
+ - `tailwind-merge`
29
+
30
+ ## Usage
31
+
32
+ ```tsx
33
+ "use client";
34
+
35
+ import { MinecraftButton } from "@/components/buttons/minecraft-button";
36
+
37
+ export function MinecraftButtonDemo() {
38
+ return (
39
+ <div className="flex items-center justify-center p-6">
40
+ <MinecraftButton>Click Me</MinecraftButton>
41
+ </div>
42
+ );
43
+ }
44
+ ```
45
+
46
+ ## API Reference
47
+
48
+ ### MinecraftButton
49
+
50
+ | Prop | Type | Default | Required | Description |
51
+ | :--- | :--- | :--- | :--- | :--- |
52
+ | `className` | `string` | — | No | Additional CSS classes |
53
+ | `children` | `React.ReactNode` | — | No | Button label content |
@@ -0,0 +1,52 @@
1
+ ---
2
+ title: "Minimal Button"
3
+ description: "Quiet dark button with hairline ring, inner specular highlight, soft shadow, and subtle chevron hover nudge."
4
+ category: "Components"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/craft/minimal-button.md"
8
+ markdown: "references/craft/minimal-button.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Minimal Button
13
+
14
+ > Quiet dark button with hairline ring, inner specular highlight, soft shadow, and subtle chevron hover nudge.
15
+
16
+ ## Install
17
+
18
+ ```bash
19
+ # Install via motion-ui skill CLI:
20
+ python scripts/install-component.py minimal-button --dest ./src
21
+ ```
22
+
23
+ ## Dependencies
24
+
25
+ - `clsx`
26
+ - `react`
27
+ - `tailwind-merge`
28
+
29
+ ## Usage
30
+
31
+ ```tsx
32
+ "use client";
33
+
34
+ import { MinimalButton } from "@/components/buttons/minimal-button";
35
+
36
+ export function MinimalButtonDemo() {
37
+ return (
38
+ <div className="flex items-center justify-center p-6">
39
+ <MinimalButton>Click Me</MinimalButton>
40
+ </div>
41
+ );
42
+ }
43
+ ```
44
+
45
+ ## API Reference
46
+
47
+ ### MinimalButton
48
+
49
+ | Prop | Type | Default | Required | Description |
50
+ | :--- | :--- | :--- | :--- | :--- |
51
+ | `className` | `string` | — | No | Additional CSS classes |
52
+ | `children` | `React.ReactNode` | — | No | Button label content |
@@ -0,0 +1,53 @@
1
+ ---
2
+ title: "Morph Status Button"
3
+ description: "Button that morphs through idle, loading, success, and error states seamlessly in place with zero layout shift."
4
+ category: "Components"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/craft/morph-status-button.md"
8
+ markdown: "references/craft/morph-status-button.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Morph Status Button
13
+
14
+ > Button that morphs through idle, loading, success, and error states seamlessly in place with zero layout shift.
15
+
16
+ ## Install
17
+
18
+ ```bash
19
+ # Install via motion-ui skill CLI:
20
+ python scripts/install-component.py morph-status-button --dest ./src
21
+ ```
22
+
23
+ ## Dependencies
24
+
25
+ - `clsx`
26
+ - `motion`
27
+ - `react`
28
+ - `tailwind-merge`
29
+
30
+ ## Usage
31
+
32
+ ```tsx
33
+ "use client";
34
+
35
+ import { MorphStatusButton } from "@/components/buttons/morph-status-button";
36
+
37
+ export function MorphStatusButtonDemo() {
38
+ return (
39
+ <div className="flex items-center justify-center p-6">
40
+ <MorphStatusButton>Click Me</MorphStatusButton>
41
+ </div>
42
+ );
43
+ }
44
+ ```
45
+
46
+ ## API Reference
47
+
48
+ ### MorphStatusButton
49
+
50
+ | Prop | Type | Default | Required | Description |
51
+ | :--- | :--- | :--- | :--- | :--- |
52
+ | `status` | `"idle" | "loading" | "success" | "error"` | "idle" | No | Current interactive state |
53
+ | `className` | `string` | — | No | Additional CSS classes |
@@ -0,0 +1,53 @@
1
+ ---
2
+ title: "Movie Pass Button"
3
+ description: "Cinema pass button that tears cleanly along perforated stub notches upon click with hinge physics."
4
+ category: "Components"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/craft/movie-pass-button.md"
8
+ markdown: "references/craft/movie-pass-button.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Movie Pass Button
13
+
14
+ > Cinema pass button that tears cleanly along perforated stub notches upon click with hinge physics.
15
+
16
+ ## Install
17
+
18
+ ```bash
19
+ # Install via motion-ui skill CLI:
20
+ python scripts/install-component.py movie-pass-button --dest ./src
21
+ ```
22
+
23
+ ## Dependencies
24
+
25
+ - `clsx`
26
+ - `motion`
27
+ - `react`
28
+ - `tailwind-merge`
29
+
30
+ ## Usage
31
+
32
+ ```tsx
33
+ "use client";
34
+
35
+ import { MoviePassButton } from "@/components/buttons/movie-pass-button";
36
+
37
+ export function MoviePassButtonDemo() {
38
+ return (
39
+ <div className="flex items-center justify-center p-6">
40
+ <MoviePassButton>Click Me</MoviePassButton>
41
+ </div>
42
+ );
43
+ }
44
+ ```
45
+
46
+ ## API Reference
47
+
48
+ ### MoviePassButton
49
+
50
+ | Prop | Type | Default | Required | Description |
51
+ | :--- | :--- | :--- | :--- | :--- |
52
+ | `className` | `string` | — | No | Additional CSS classes |
53
+ | `children` | `React.ReactNode` | — | No | Button pass label content |