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.
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,58 @@
1
+ ---
2
+ title: "Matrix Dot Loader"
3
+ description: "Sci-fi matrix dot grid indicator with synchronized harmonic waves, radial ripple pulses, and binary activity feedback."
4
+ category: "Motion"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/motion/matrix-dot-loader.md"
8
+ markdown: "references/motion/matrix-dot-loader.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Matrix Dot Loader
13
+
14
+ > Sci-fi matrix dot grid indicator with synchronized harmonic waves, radial ripple pulses, and binary activity feedback.
15
+
16
+ High-tech loader pattern from [transitions.dev](https://github.com/Jakubantalik/transitions.dev). Uses a 2D matrix of dots whose scale and opacity oscillate in harmonic diagonal phase waves.
17
+
18
+ ## Install
19
+
20
+ ```bash
21
+ # Install via motion-ui skill CLI:
22
+ python scripts/install-component.py matrix-dot-loader --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 { MatrixDotLoader } from "@/components/motion/matrix-dot-loader";
38
+
39
+ export function MatrixDotLoaderDemo() {
40
+ return (
41
+ <div className="flex items-center justify-center p-8">
42
+ <MatrixDotLoader rows={4} cols={4} size={8} gap={8} />
43
+ </div>
44
+ );
45
+ }
46
+ ```
47
+
48
+ ## API Reference
49
+
50
+ ### MatrixDotLoader
51
+
52
+ | Prop | Type | Default | Required | Description |
53
+ | :--- | :--- | :--- | :--- | :--- |
54
+ | `rows` | `number` | `4` | No | Number of vertical dot rows |
55
+ | `cols` | `number` | `4` | No | Number of horizontal dot columns |
56
+ | `size` | `number` | `6` | No | Diameter of each dot in pixels |
57
+ | `gap` | `number` | `6` | No | Spacing between dots in pixels |
58
+ | `className` | `string` | — | No | Additional CSS classes |
@@ -0,0 +1,63 @@
1
+ ---
2
+ title: "Organic Shimmer"
3
+ description: "Organic fluid light sheen moving across card surfaces, adapting dynamically to border radius, tilt angle, and lighting conditions."
4
+ category: "Motion"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/motion/organic-shimmer.md"
8
+ markdown: "references/motion/organic-shimmer.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Organic Shimmer
13
+
14
+ > Organic fluid light sheen moving across card surfaces, adapting dynamically to border radius, tilt angle, and lighting conditions.
15
+
16
+ Surface highlight pattern from [transitions.dev](https://github.com/Jakubantalik/transitions.dev). Unlike harsh linear gradient bars, this shimmer casts a soft blurred oblique wash with variable easing and rest delays.
17
+
18
+ ## Install
19
+
20
+ ```bash
21
+ # Install via motion-ui skill CLI:
22
+ python scripts/install-component.py organic-shimmer --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 { OrganicShimmer } from "@/components/motion/organic-shimmer";
38
+
39
+ export function OrganicShimmerDemo() {
40
+ return (
41
+ <div className="flex items-center justify-center p-8">
42
+ <OrganicShimmer className="w-80">
43
+ <h3 className="text-base font-semibold text-neutral-900 dark:text-neutral-100">
44
+ Real-time Telemetry
45
+ </h3>
46
+ <p className="text-xs text-neutral-500 mt-1">
47
+ Active instances streaming performance events across clusters.
48
+ </p>
49
+ </OrganicShimmer>
50
+ </div>
51
+ );
52
+ }
53
+ ```
54
+
55
+ ## API Reference
56
+
57
+ ### OrganicShimmer
58
+
59
+ | Prop | Type | Default | Required | Description |
60
+ | :--- | :--- | :--- | :--- | :--- |
61
+ | `children` | `React.ReactNode` | Skeleton card rows | No | Inner container elements |
62
+ | `duration` | `number` | `2.4` | No | Cycle duration of shimmer sweep in seconds |
63
+ | `className` | `string` | — | No | Additional CSS classes |
@@ -0,0 +1,57 @@
1
+ ---
2
+ title: "Pro Gradient Text"
3
+ description: "High-performance multi-stop moving gradient typography with configurable angle, speed, chromatic spectrum, and mask clipping."
4
+ category: "Motion"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/motion/pro-gradient-text.md"
8
+ markdown: "references/motion/pro-gradient-text.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Pro Gradient Text
13
+
14
+ > High-performance multi-stop moving gradient typography with configurable angle, speed, chromatic spectrum, and mask clipping.
15
+
16
+ High-impact headline gradient animation from [transitions.dev](https://github.com/Jakubantalik/transitions.dev). Uses GPU-composited background-position translation on background-clip: text.
17
+
18
+ ## Install
19
+
20
+ ```bash
21
+ # Install via motion-ui skill CLI:
22
+ python scripts/install-component.py pro-gradient-text --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 { ProGradientText } from "@/components/motion/pro-gradient-text";
38
+
39
+ export function ProGradientTextDemo() {
40
+ return (
41
+ <div className="flex items-center justify-center p-8 text-center">
42
+ <ProGradientText>Autonomous AI Components</ProGradientText>
43
+ </div>
44
+ );
45
+ }
46
+ ```
47
+
48
+ ## API Reference
49
+
50
+ ### ProGradientText
51
+
52
+ | Prop | Type | Default | Required | Description |
53
+ | :--- | :--- | :--- | :--- | :--- |
54
+ | `children` | `React.ReactNode` | `"Engineered for Velocity"` | No | Text content |
55
+ | `colors` | `string[]` | 6 chromatic stops | No | Array of hex or rgba color stops |
56
+ | `duration` | `number` | `6` | No | Cycle speed in seconds |
57
+ | `className` | `string` | — | No | Additional CSS classes |
@@ -0,0 +1,67 @@
1
+ ---
2
+ title: "Skeleton Loader and Reveal"
3
+ description: "Adaptive content skeleton with rhythmic shimmer wave that cross-fades directly into live UI surfaces with zero cumulative layout shift."
4
+ category: "Motion"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/motion/skeleton-loader-and-reveal.md"
8
+ markdown: "references/motion/skeleton-loader-and-reveal.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Skeleton Loader and Reveal
13
+
14
+ > Adaptive content skeleton with rhythmic shimmer wave that cross-fades directly into live UI surfaces with zero cumulative layout shift.
15
+
16
+ The canonical progressive loading pattern from [transitions.dev](https://github.com/Jakubantalik/transitions.dev). Preserves exact bounding dimensions between loading skeletons and incoming data cards, using directional blur crossfades.
17
+
18
+ ## Install
19
+
20
+ ```bash
21
+ # Install via motion-ui skill CLI:
22
+ python scripts/install-component.py skeleton-loader-and-reveal --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 { SkeletonLoaderAndReveal } from "@/components/motion/skeleton-loader-and-reveal";
39
+
40
+ export function SkeletonLoaderAndRevealDemo() {
41
+ const [loading, setLoading] = useState(true);
42
+
43
+ return (
44
+ <div className="flex flex-col items-center gap-4 p-8">
45
+ <SkeletonLoaderAndReveal isLoading={loading} />
46
+ <button
47
+ type="button"
48
+ onClick={() => setLoading(!loading)}
49
+ className="px-3 py-1.5 text-xs font-semibold rounded-lg bg-neutral-100 dark:bg-neutral-800 text-neutral-700 dark:text-neutral-300"
50
+ >
51
+ Toggle Loaded State
52
+ </button>
53
+ </div>
54
+ );
55
+ }
56
+ ```
57
+
58
+ ## API Reference
59
+
60
+ ### SkeletonLoaderAndReveal
61
+
62
+ | Prop | Type | Default | Required | Description |
63
+ | :--- | :--- | :--- | :--- | :--- |
64
+ | `isLoading` | `boolean` | `true` | No | Current loading status |
65
+ | `skeletonContent` | `React.ReactNode` | Default profile skeleton | No | Custom skeleton placeholder UI |
66
+ | `children` | `React.ReactNode` | Default card content | No | Live populated UI surface |
67
+ | `className` | `string` | — | No | Additional CSS classes |
@@ -0,0 +1,67 @@
1
+ ---
2
+ title: "Spinner to Check Morph"
3
+ description: "Continuous SVG arc loading spinner that morphs smoothly into an animated checkmark path upon async task completion."
4
+ category: "Motion"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/motion/spinner-to-check-morph.md"
8
+ markdown: "references/motion/spinner-to-check-morph.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Spinner to Check Morph
13
+
14
+ > Continuous SVG arc loading spinner that morphs smoothly into an animated checkmark path upon async task completion.
15
+
16
+ The canonical success transition from [transitions.dev](https://github.com/Jakubantalik/transitions.dev). The spinning perimeter ring resolves cleanly into a full circle while an SVG checkmark traces itself across the center.
17
+
18
+ ## Install
19
+
20
+ ```bash
21
+ # Install via motion-ui skill CLI:
22
+ python scripts/install-component.py spinner-to-check-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 { useState } from "react";
38
+ import { SpinnerToCheckMorph } from "@/components/motion/spinner-to-check-morph";
39
+
40
+ export function SpinnerToCheckMorphDemo() {
41
+ const [status, setStatus] = useState<"loading" | "success">("loading");
42
+
43
+ return (
44
+ <div className="flex flex-col items-center gap-4 p-8">
45
+ <SpinnerToCheckMorph status={status} size={48} />
46
+ <button
47
+ type="button"
48
+ onClick={() => setStatus(status === "loading" ? "success" : "loading")}
49
+ className="px-3 py-1.5 text-xs font-semibold rounded-lg bg-neutral-100 dark:bg-neutral-800 text-neutral-700 dark:text-neutral-300"
50
+ >
51
+ Toggle Status
52
+ </button>
53
+ </div>
54
+ );
55
+ }
56
+ ```
57
+
58
+ ## API Reference
59
+
60
+ ### SpinnerToCheckMorph
61
+
62
+ | Prop | Type | Default | Required | Description |
63
+ | :--- | :--- | :--- | :--- | :--- |
64
+ | `status` | `"loading" \| "success" \| "idle"` | `"loading"` | No | Current visual state |
65
+ | `size` | `number` | `40` | No | Bounding diameter in pixels |
66
+ | `strokeWidth` | `number` | `3.5` | No | SVG stroke width |
67
+ | `className` | `string` | — | No | Additional CSS classes |
@@ -0,0 +1,74 @@
1
+ ---
2
+ title: "Spinning Counter"
3
+ description: "Mechanical odometer spinning counter dial with velocity spring damping, vertical digit slots, and directional blur."
4
+ category: "Motion"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/motion/spinning-counter.md"
8
+ markdown: "references/motion/spinning-counter.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Spinning Counter
13
+
14
+ > Mechanical odometer spinning counter dial with velocity spring damping, vertical digit slots, and directional blur.
15
+
16
+ Odometer counter transition from [transitions.dev](https://github.com/Jakubantalik/transitions.dev). When numbers increment or decrement, each digit scrolls vertically along a 0–9 wheel with spring damping.
17
+
18
+ ## Install
19
+
20
+ ```bash
21
+ # Install via motion-ui skill CLI:
22
+ python scripts/install-component.py spinning-counter --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 { SpinningCounter } from "@/components/motion/spinning-counter";
39
+
40
+ export function SpinningCounterDemo() {
41
+ const [val, setVal] = useState(1284);
42
+
43
+ return (
44
+ <div className="flex flex-col items-center gap-4 p-8">
45
+ <SpinningCounter value={val} />
46
+ <div className="flex gap-2">
47
+ <button
48
+ type="button"
49
+ onClick={() => setVal((v) => v - 10)}
50
+ className="px-3 py-1 text-xs rounded border border-neutral-300"
51
+ >
52
+ -10
53
+ </button>
54
+ <button
55
+ type="button"
56
+ onClick={() => setVal((v) => v + 25)}
57
+ className="px-3 py-1 text-xs rounded border border-neutral-300"
58
+ >
59
+ +25
60
+ </button>
61
+ </div>
62
+ </div>
63
+ );
64
+ }
65
+ ```
66
+
67
+ ## API Reference
68
+
69
+ ### SpinningCounter
70
+
71
+ | Prop | Type | Default | Required | Description |
72
+ | :--- | :--- | :--- | :--- | :--- |
73
+ | `value` | `number` | — | Yes | Target numerical value to display |
74
+ | `className` | `string` | — | No | Additional CSS classes |
@@ -0,0 +1,64 @@
1
+ ---
2
+ title: "Text Morph"
3
+ description: "In-place text transition that pins shared character prefixes and suffixes while smoothly cross-blurring and easing changing middle letters."
4
+ category: "Motion"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/motion/text-morph.md"
8
+ markdown: "references/motion/text-morph.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Text Morph
13
+
14
+ > In-place text transition that pins shared character prefixes and suffixes while smoothly cross-blurring and easing changing middle letters.
15
+
16
+ The canonical text morph pattern from [transitions.dev](https://github.com/Jakubantalik/transitions.dev). Ideal for button labels and micro-states that share letters (e.g., "Copy code" $\to$ "Copied", "Follow" $\to$ "Following", "Save" $\to$ "Saved"). The shared letters stay anchored; only the differing characters cross-fade with directional blur.
17
+
18
+ ## Install
19
+
20
+ ```bash
21
+ # Install via motion-ui skill CLI:
22
+ python scripts/install-component.py text-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 { useState } from "react";
38
+ import { TextMorph } from "@/components/motion/text-morph";
39
+
40
+ export function TextMorphDemo() {
41
+ const [copied, setCopied] = useState(false);
42
+
43
+ return (
44
+ <div className="flex items-center justify-center p-8">
45
+ <button
46
+ type="button"
47
+ onClick={() => setCopied(!copied)}
48
+ className="px-4 py-2 rounded-xl border border-neutral-300 dark:border-neutral-700 bg-white dark:bg-neutral-900 text-sm font-semibold text-neutral-900 dark:text-neutral-100 shadow-sm"
49
+ >
50
+ <TextMorph text={copied ? "Copied" : "Copy code"} />
51
+ </button>
52
+ </div>
53
+ );
54
+ }
55
+ ```
56
+
57
+ ## API Reference
58
+
59
+ ### TextMorph
60
+
61
+ | Prop | Type | Default | Required | Description |
62
+ | :--- | :--- | :--- | :--- | :--- |
63
+ | `text` | `string` | — | Yes | Target label string to morph into |
64
+ | `className` | `string` | — | No | Additional CSS classes |
@@ -0,0 +1,56 @@
1
+ ---
2
+ title: "Texts Reveal"
3
+ description: "Typographic text reveal container staggering words and lines along spring trajectories with opacity and directional drift."
4
+ category: "Motion"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/motion/texts-reveal.md"
8
+ markdown: "references/motion/texts-reveal.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Texts Reveal
13
+
14
+ > Typographic text reveal container staggering words and lines along spring trajectories with opacity and directional drift.
15
+
16
+ Editorial reveal animation from [transitions.dev](https://github.com/Jakubantalik/transitions.dev). Words rise from within masked line slots with staggered cubic-bezier velocity.
17
+
18
+ ## Install
19
+
20
+ ```bash
21
+ # Install via motion-ui skill CLI:
22
+ python scripts/install-component.py texts-reveal --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 { TextsReveal } from "@/components/motion/texts-reveal";
38
+
39
+ export function TextsRevealDemo() {
40
+ return (
41
+ <div className="flex items-center justify-center p-8 max-w-xl">
42
+ <TextsReveal text="Building the next generation of autonomous design systems." />
43
+ </div>
44
+ );
45
+ }
46
+ ```
47
+
48
+ ## API Reference
49
+
50
+ ### TextsReveal
51
+
52
+ | Prop | Type | Default | Required | Description |
53
+ | :--- | :--- | :--- | :--- | :--- |
54
+ | `text` | `string` | Default platform headline | No | Raw string decomposed into staggered word spans |
55
+ | `stagger` | `number` | `0.04` | No | Stagger delay between words in seconds |
56
+ | `className` | `string` | — | No | Additional CSS classes |
@@ -5,6 +5,7 @@ from pathlib import Path
5
5
 
6
6
  ROOT = Path(__file__).resolve().parent.parent
7
7
  catalog = json.loads((ROOT / "catalog.json").read_text(encoding="utf-8"))
8
+ version = json.loads((ROOT / "package.json").read_text(encoding="utf-8"))["version"]
8
9
  comps = catalog["components"]
9
10
  total_count = len(comps)
10
11
 
@@ -74,7 +75,7 @@ description: >-
74
75
  license: MIT
75
76
  metadata:
76
77
  author: Rkj0123
77
- version: "2.0.0"
78
+ version: "{version}"
78
79
  ---
79
80
 
80
81
  # Motion UI Skill
@@ -238,6 +239,32 @@ Tactile 3D buttons, neumorphic controls, high-fidelity device mockups, backgroun
238
239
 
239
240
  ---
240
241
 
242
+ ## Design Search Engine & UI Reasoning
243
+
244
+ Search across 67 UI style families, industry-mapped color palettes, font pairings, chart selectors, and stack guidelines:
245
+
246
+ ```bash
247
+ # Search by style (e.g. glassmorphism, brutalism, minimal, retro, bento)
248
+ python scripts/search.py "glassmorphism" --domain style
249
+
250
+ # Search industry color palette (e.g. fintech, saas, healthcare, devtools)
251
+ python scripts/search.py "fintech" --domain color
252
+
253
+ # Search typography pairings (e.g. editorial, technical, playful, modern)
254
+ python scripts/search.py "editorial" --domain typography
255
+
256
+ # Search optimal chart type (e.g. time series, retention, distribution, comparison)
257
+ python scripts/search.py "retention" --domain chart
258
+
259
+ # Search UX best practices (e.g. modal, checkout, form, error)
260
+ python scripts/search.py "form" --domain ux
261
+
262
+ # Generate a complete cohesive design system for a product domain
263
+ python scripts/search.py "Crypto Trading Platform" --design-system
264
+ ```
265
+
266
+ ---
267
+
241
268
  ## Motion Guides & Best Practices
242
269
 
243
270
  For in-depth animation principles, design system checklists, and accessibility rules, read:
@@ -247,7 +274,10 @@ For in-depth animation principles, design system checklists, and accessibility r
247
274
  - [`references/guides/motion-engineering.md`](./references/guides/motion-engineering.md): Deep dive into `motion/react`, physics-based springs, `layoutId`, `AnimatePresence`, gestures, and hardware acceleration.
248
275
  - [`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.
249
276
  - [`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.
250
- - [`references/guides/interaction-transitions.md`](./references/guides/interaction-transitions.md): The 12 canonical interaction transitions from Transitions.dev with token specs and timing tables.
277
+ - [`references/guides/interaction-transitions.md`](./references/guides/interaction-transitions.md): The canonical 43 interaction transitions from Transitions.dev with token specs and timing tables.
278
+ - [`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.
279
+ - [`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.
280
+ - [`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.
251
281
  - [`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.
252
282
  - [`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.
253
283
  - [`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.
@@ -447,7 +477,10 @@ Ensure your `tailwind.config.js` or `globals.css` supports CSS variable colors (
447
477
  - [Motion Engineering Guide](./references/guides/motion-engineering.md): Motion v12/v13+ architecture, spring formulas, shared layoutId morphs, and AnimatePresence.
448
478
  - [Motion Performance & 60/120 FPS](./references/guides/motion-performance.md): Compositor properties, avoiding layout thrashing, and layer budgets.
449
479
  - [Baseline UI Craft & Anti-Slop](./references/guides/baseline-ui-craft.md): Design engineering principles, optical alignment, spacing rhythm, and micro-interactions.
450
- - [The 12 Canonical Interaction Transitions](./references/guides/interaction-transitions.md): Transitions.dev interaction patterns and token specs.
480
+ - [The Canonical Interaction Transitions Guide](./references/guides/interaction-transitions.md): Transitions.dev interaction patterns, 43 canonical transitions, and token specs.
481
+ - [Motion Polish & Interaction Rules Guide](./references/guides/motion-polish-rules.md): Micro-distance scales (4px, 6px, 8px, 12px, 30px) and progressive UI generation.
482
+ - [Design Intelligence & UI Reasoning Guide](./references/guides/design-intelligence.md): 67 UI style families, industry-mapped color palettes, font pairings, chart selectors, and CRO landing architectures.
483
+ - [Modern Stack Best Practices Guide](./references/guides/stack-best-practices.md): Framework integration guidelines covering Next.js App Router, React 19, Tailwind v3/v4, and Motion.
451
484
  - [Universal Mobile-First Interaction Patterns](./references/guides/universal-mobile-patterns.md): Touch ergonomics, haptic feedback semantics, and swipe gestures.
452
485
  - [Craft & Surface Design System](./references/guides/craft-surface-design-system.md): Visual language, tactile 3D elevation, typography pairing, and component patterns.
453
486
  - [Enterprise Dashboard Architecture](./references/guides/enterprise-dashboard-patterns.md): High-density data grids, kanban boards, faceted query builders, and timelines.
@@ -521,6 +554,7 @@ motion-ui-skill/
521
554
  │ ├── agents/ # {len(agents_items)} conversational agent surfaces
522
555
  │ ├── previews/ # Component preview & demo implementations
523
556
  │ └── [category]/ # {len(craft_items)} craft & surface component files across categories
557
+ ├── data/ # Design intelligence datasets (styles, colors, typography, charts, stacks)
524
558
  ├── icons/ # 21 custom brand and annotation icons
525
559
  ├── lib/ # Foundation tokens, easing physics, and utility hooks
526
560
  │ ├── ease.ts # Easing curves and spring physics constants
@@ -533,13 +567,14 @@ motion-ui-skill/
533
567
  │ ├── agents/ # {len(agents_items)} agent component guides
534
568
  │ ├── blocks/ # {guide_counts.get("blocks", 0)} block guides
535
569
  │ ├── craft/ # {guide_counts.get("craft", 0)} craft and surface component guides
536
- │ ├── guides/ # Complete suite of 10 motion & design system guides
570
+ │ ├── guides/ # Complete suite of 13 motion & design system guides
537
571
  │ └── codex-install.md # Codex app and CLI installation guide
538
572
  ├── prompts/
539
573
  │ └── install-motion-ui.md # Copy-paste prompt for AI-agent installation
540
574
  ├── evals/
541
575
  │ └── catalog_eval.py # Dependency-free catalog coverage evaluation
542
576
  └── scripts/
577
+ ├── search.py # Terminal design reasoning search engine (BM25)
543
578
  ├── install-component.py # Standalone CLI tool to install components into projects
544
579
  ├── build_docs.py # Script to synchronize SKILL.md and README.md from catalog
545
580
  ├── verify_skill.py # Dependency-free package integrity gate