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,26 @@
1
+ import type React from "react";
2
+
3
+ export type IconProps = React.SVGProps<SVGSVGElement> & {
4
+ size?: number | string;
5
+ color?: string;
6
+ };
7
+
8
+
9
+ export const ShadcnUI = ({
10
+ size = 24,
11
+ color = "currentColor",
12
+ className,
13
+ ...props
14
+ }: IconProps) => (
15
+ <svg
16
+ xmlns="http://www.w3.org/2000/svg"
17
+ width={size}
18
+ height={size}
19
+ viewBox="0 0 24 24"
20
+ fill={color}
21
+ className={className}
22
+ {...props}
23
+ >
24
+ <path d="m19.01 11.55-7.46 7.46c-.46.46-.46 1.19 0 1.65a1.16 1.16 0 0 0 1.64 0l7.46-7.46c.46-.46.46-1.19 0-1.65s-1.19-.46-1.65 0Zm.16-8.21c-.46-.46-1.19-.46-1.65 0L3.34 17.52c-.46.46-.46 1.19 0 1.65a1.16 1.16 0 0 0 1.64 0L19.16 4.99c.46-.46.46-1.19 0-1.65Z"></path>
25
+ </svg>
26
+ );
@@ -0,0 +1,26 @@
1
+ import type React from "react";
2
+
3
+ export type IconProps = React.SVGProps<SVGSVGElement> & {
4
+ size?: number | string;
5
+ color?: string;
6
+ };
7
+
8
+
9
+ export const TailwindCSS = ({
10
+ size = 14,
11
+ color = "currentColor",
12
+ className,
13
+ ...props
14
+ }: IconProps) => (
15
+ <svg
16
+ xmlns="http://www.w3.org/2000/svg"
17
+ viewBox="0 0 24 24"
18
+ width={size}
19
+ height={size}
20
+ fill={color}
21
+ className={className}
22
+ {...props}
23
+ >
24
+ <path d="M18.5 9.51a4.2 4.2 0 0 1-1.91-1.34A5.77 5.77 0 0 0 12 6a4.72 4.72 0 0 0-5 4 3.23 3.23 0 0 1 3.5-1.49 4.3 4.3 0 0 1 1.91 1.35A5.77 5.77 0 0 0 17 12a4.72 4.72 0 0 0 5-4 3.2 3.2 0 0 1-3.5 1.51m-13 4.98a4.2 4.2 0 0 1 1.91 1.34A5.77 5.77 0 0 0 12 18a4.72 4.72 0 0 0 5-4 3.23 3.23 0 0 1-3.5 1.49 4.3 4.3 0 0 1-1.91-1.35A5.8 5.8 0 0 0 7 12a4.72 4.72 0 0 0-5 4 3.2 3.2 0 0 1 3.5-1.51" />
25
+ </svg>
26
+ );
@@ -0,0 +1,30 @@
1
+ import type React from "react";
2
+
3
+ export type IconProps = React.SVGProps<SVGSVGElement> & {
4
+ size?: number | string;
5
+ color?: string;
6
+ };
7
+
8
+
9
+ export const Twitter = ({
10
+ size = 12,
11
+ color = "currentColor",
12
+ className,
13
+ ...props
14
+ }: IconProps) => (
15
+ <svg
16
+ width={size}
17
+ height={size}
18
+ viewBox="0 0 1200 1227"
19
+ fill="none"
20
+ color={color}
21
+ xmlns="http://www.w3.org/2000/svg"
22
+ className={className}
23
+ {...props}
24
+ >
25
+ <path
26
+ d="M714.163 519.284L1160.89 0H1055.03L667.137 450.887L357.328 0H0L468.492 681.821L0 1226.37H105.866L515.491 750.218L842.672 1226.37H1200L714.137 519.284H714.163ZM569.165 687.828L521.697 619.934L144.011 79.6944H306.615L611.412 515.685L658.88 583.579L1055.08 1150.3H892.476L569.165 687.854V687.828Z"
27
+ fill="currentColor"
28
+ />
29
+ </svg>
30
+ );
@@ -0,0 +1,26 @@
1
+ import type React from "react";
2
+
3
+ export type IconProps = React.SVGProps<SVGSVGElement> & {
4
+ size?: number | string;
5
+ color?: string;
6
+ };
7
+
8
+
9
+ export const Typescript = ({
10
+ size = 14,
11
+ color = "currentColor",
12
+ className,
13
+ ...props
14
+ }: IconProps) => (
15
+ <svg
16
+ xmlns="http://www.w3.org/2000/svg"
17
+ viewBox="0 0 24 24"
18
+ width={size}
19
+ height={size}
20
+ fill={color}
21
+ className={className}
22
+ {...props}
23
+ >
24
+ <path d="M19.24 3H4.76A1.76 1.76 0 0 0 3 4.76v14.48A1.76 1.76 0 0 0 4.76 21h14.48A1.76 1.76 0 0 0 21 19.24V4.76A1.76 1.76 0 0 0 19.24 3m-5.8 10h-2.25v6.44H9.4V13H7.15v-1.46h6.29zm5.8 5.28a1.7 1.7 0 0 1-.67.74 3 3 0 0 1-1 .39 6 6 0 0 1-1.2.12 7 7 0 0 1-1.23-.11 4.5 4.5 0 0 1-1-.33v-1.71l-.06-.06h.06v.07a3.4 3.4 0 0 0 1 .54 3.1 3.1 0 0 0 1.13.2 2.6 2.6 0 0 0 .6-.06 1.5 1.5 0 0 0 .42-.17.75.75 0 0 0 .25-.25.69.69 0 0 0-.06-.74 1.2 1.2 0 0 0-.35-.33 3 3 0 0 0-.53-.3l-.67-.28a3.6 3.6 0 0 1-1.37-1 2 2 0 0 1-.46-1.33 2.16 2.16 0 0 1 .24-1.06 2.1 2.1 0 0 1 .66-.71 2.9 2.9 0 0 1 1-.42 5 5 0 0 1 1.19-.13 7 7 0 0 1 1.09.07 4.5 4.5 0 0 1 .88.23v1.65a2.4 2.4 0 0 0-.42-.24 4 4 0 0 0-.49-.17 3 3 0 0 0-.49-.1 2.5 2.5 0 0 0-.46 0 2.3 2.3 0 0 0-.56.06 1.5 1.5 0 0 0-.43.16.8.8 0 0 0-.26.25.63.63 0 0 0-.09.33.6.6 0 0 0 .1.35 1.2 1.2 0 0 0 .3.29 2.2 2.2 0 0 0 .46.28l.63.28a7 7 0 0 1 .84.42 2.7 2.7 0 0 1 .64.49 1.8 1.8 0 0 1 .42.63 2.5 2.5 0 0 1 .14.85 2.7 2.7 0 0 1-.25 1.08z" />
25
+ </svg>
26
+ );
@@ -0,0 +1,27 @@
1
+ import type React from "react";
2
+
3
+ export type IconProps = React.SVGProps<SVGSVGElement> & {
4
+ size?: number | string;
5
+ color?: string;
6
+ };
7
+
8
+ export const Unsplash = ({
9
+ size = 24,
10
+ color = "currentColor",
11
+ className,
12
+ ...props
13
+ }: IconProps) => (
14
+ <svg
15
+ xmlns="http://www.w3.org/2000/svg"
16
+ width={size}
17
+ height={size}
18
+ viewBox="0 0 24 24"
19
+ fill={color}
20
+ className={className}
21
+ {...props}
22
+ >
23
+ <path d="M8.625 8.063V3h6.75v5.063zm6.75 2.812H21V21H3V10.875h5.625v5.063h6.75z"></path>
24
+ </svg>
25
+ );
26
+
27
+ export const Unplash = Unsplash;
@@ -0,0 +1,26 @@
1
+ import type React from "react";
2
+
3
+ export type IconProps = React.SVGProps<SVGSVGElement> & {
4
+ size?: number | string;
5
+ color?: string;
6
+ };
7
+
8
+
9
+ export const Vercel = ({
10
+ size = 24,
11
+ color = "currentColor",
12
+ className,
13
+ ...props
14
+ }: IconProps) => (
15
+ <svg
16
+ xmlns="http://www.w3.org/2000/svg"
17
+ width={size}
18
+ height={size}
19
+ viewBox="0 0 24 24"
20
+ fill={color}
21
+ className={className}
22
+ {...props}
23
+ >
24
+ <path d="M24 22.525H0l12-21.05 12 21.05z" />
25
+ </svg>
26
+ );
@@ -0,0 +1,26 @@
1
+ import type React from "react";
2
+
3
+ export type IconProps = React.SVGProps<SVGSVGElement> & {
4
+ size?: number | string;
5
+ color?: string;
6
+ };
7
+
8
+
9
+ export const WhatsApp = ({
10
+ size = 14,
11
+ color = "currentColor",
12
+ className,
13
+ ...props
14
+ }: IconProps) => (
15
+ <svg
16
+ xmlns="http://www.w3.org/2000/svg"
17
+ viewBox="0 0 24 24"
18
+ width={size}
19
+ height={size}
20
+ fill={color}
21
+ className={className}
22
+ {...props}
23
+ >
24
+ <path d="M17.472 14.382c-.297-.149-1.758-.867-2.03-.967-.273-.099-.471-.148-.67.15-.197.297-.767.966-.94 1.164-.173.199-.347.223-.644.075-.297-.15-1.255-.463-2.39-1.475-.883-.788-1.48-1.761-1.653-2.059-.173-.297-.018-.458.13-.606.134-.133.298-.347.446-.52.149-.174.198-.298.298-.497.099-.198.05-.371-.025-.52-.075-.149-.669-1.612-.916-2.207-.242-.579-.487-.5-.669-.51-.173-.008-.371-.01-.57-.01-.198 0-.52.074-.792.372-.272.297-1.04 1.016-1.04 2.479 0 1.462 1.065 2.875 1.213 3.074.149.198 2.096 3.2 5.077 4.487.709.306 1.262.489 1.694.625.712.227 1.36.195 1.871.118.571-.085 1.758-.719 2.006-1.413.248-.694.248-1.289.173-1.413-.074-.124-.272-.198-.57-.347m-5.421 7.403h-.004a9.87 9.87 0 0 1-5.031-1.378l-.361-.214-3.741.982.998-3.648-.235-.374a9.86 9.86 0 0 1-1.51-5.26c.001-5.45 4.436-9.884 9.888-9.884 2.64 0 5.122 1.03 6.988 2.898a9.825 9.825 0 0 1 2.893 6.994c-.003 5.45-4.437 9.884-9.885 9.884m8.413-18.297A11.815 11.815 0 0 0 12.05 0C5.495 0 .16 5.335.157 11.892c0 2.096.547 4.142 1.588 5.945L.057 24l6.305-1.654a11.882 11.882 0 0 0 5.683 1.448h.005c6.554 0 11.89-5.335 11.893-11.893a11.821 11.821 0 0 0-3.48-8.413Z" />
25
+ </svg>
26
+ );
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "motion-ui-skill",
3
- "version": "2.0.0",
3
+ "version": "2.1.1",
4
4
  "type": "module",
5
5
  "engines": {
6
6
  "node": ">=18"
@@ -12,14 +12,20 @@
12
12
  "files": [
13
13
  "bin",
14
14
  "components",
15
+ "data",
15
16
  "lib",
16
17
  "references",
17
- "scripts",
18
+ "scripts/**/*.py",
19
+ "scripts/**/*.mjs",
18
20
  "catalog.json",
19
21
  "SKILL.md",
20
22
  "README.md",
21
23
  "LICENSE",
22
- "agents"
24
+ "agents",
25
+ "prompts",
26
+ "evals",
27
+ "test",
28
+ "icons"
23
29
  ],
24
30
  "scripts": {
25
31
  "test": "node test/test_installer.mjs",
@@ -0,0 +1,17 @@
1
+ # AI-agent installation prompt
2
+
3
+ Copy and paste this prompt into Codex, Claude Code, Cursor, Windsurf, or another agent that can run terminal commands:
4
+
5
+ ```text
6
+ Install the Motion UI skill from https://github.com/Rkj0123/motion-ui-skill for this project.
7
+
8
+ 1. Detect the current coding agent and use the skills CLI if it is available.
9
+ 2. Install the skill project-scoped with the equivalent of:
10
+ npx skills add Rkj0123/motion-ui-skill --skill motion-ui --agent <current-agent> --copy -y
11
+ 3. If the current agent is Codex, use --agent codex.
12
+ 4. Do not install globally unless I explicitly ask.
13
+ 5. Verify that .agents/skills/motion-ui/SKILL.md exists and that the installed skill is listed.
14
+ 6. Report the install path and stop. Do not change application source files.
15
+ ```
16
+
17
+ For a manual Codex install, use the commands in [`references/codex-install.md`](../references/codex-install.md).
@@ -0,0 +1,56 @@
1
+ ---
2
+ title: "Thinking States"
3
+ description: "Conversational AI agent thinking bubble morphing through cognitive stages (evaluating, searching, reasoning, finalizing) with organic pulse dots."
4
+ category: "Agents"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/agents/thinking-states.md"
8
+ markdown: "references/agents/thinking-states.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Thinking States
13
+
14
+ > Conversational AI agent thinking bubble morphing through cognitive stages (evaluating, searching, reasoning, finalizing) with organic pulse dots.
15
+
16
+ Synthesized from conversational agent UX patterns in [transitions.dev](https://github.com/Jakubantalik/transitions.dev). Replaces static spinners with dynamic status morphs that give users clear transparency into LLM planning and tool execution.
17
+
18
+ ## Install
19
+
20
+ ```bash
21
+ # Install via motion-ui skill CLI:
22
+ python scripts/install-component.py thinking-states --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 { ThinkingStates } from "@/components/agents/thinking-states";
38
+
39
+ export function ThinkingStatesDemo() {
40
+ return (
41
+ <div className="flex items-center justify-center p-8">
42
+ <ThinkingStates autoCycle={true} />
43
+ </div>
44
+ );
45
+ }
46
+ ```
47
+
48
+ ## API Reference
49
+
50
+ ### ThinkingStates
51
+
52
+ | Prop | Type | Default | Required | Description |
53
+ | :--- | :--- | :--- | :--- | :--- |
54
+ | `stage` | `"evaluating" \| "searching" \| "reasoning" \| "synthesizing" \| "finalizing"` | Controlled / internal cycle | No | Explicit stage override |
55
+ | `autoCycle` | `boolean` | `true` | No | Automatically cycle through stages for demonstration |
56
+ | `className` | `string` | — | No | Additional CSS classes |
@@ -0,0 +1,53 @@
1
+ ---
2
+ title: "Aqua Button"
3
+ description: "Glossy pill button inspired by Apple classic Aqua interface, with layered highlights and soft inner glow."
4
+ category: "Components"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/craft/aqua-button.md"
8
+ markdown: "references/craft/aqua-button.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Aqua Button
13
+
14
+ > Glossy pill button inspired by Apple classic Aqua interface, with layered highlights and soft inner glow.
15
+
16
+ ## Install
17
+
18
+ ```bash
19
+ # Install via motion-ui skill CLI:
20
+ python scripts/install-component.py aqua-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 { AquaButton } from "@/components/buttons/aqua-button";
35
+
36
+ export function AquaButtonDemo() {
37
+ return (
38
+ <div className="flex items-center justify-center p-6">
39
+ <AquaButton>Click Me</AquaButton>
40
+ </div>
41
+ );
42
+ }
43
+ ```
44
+
45
+ ## API Reference
46
+
47
+ ### AquaButton
48
+
49
+ | Prop | Type | Default | Required | Description |
50
+ | :--- | :--- | :--- | :--- | :--- |
51
+ | `variant` | `"primary" | "secondary"` | "primary" | No | Visual colorway style |
52
+ | `className` | `string` | — | No | Additional CSS classes |
53
+ | `children` | `React.ReactNode` | — | No | Button label or icon content |
@@ -0,0 +1,55 @@
1
+ ---
2
+ title: "Ash Burst Button"
3
+ description: "Ringed dark button that glows like an ember on click and erupts realistic ash particles using Matter.js physics."
4
+ category: "Components"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/craft/ash-burst-button.md"
8
+ markdown: "references/craft/ash-burst-button.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Ash Burst Button
13
+
14
+ > Ringed dark button that glows like an ember on click and erupts realistic ash particles using Matter.js physics.
15
+
16
+ ## Install
17
+
18
+ ```bash
19
+ # Install via motion-ui skill CLI:
20
+ python scripts/install-component.py ash-burst-button --dest ./src
21
+ ```
22
+
23
+ ## Dependencies
24
+
25
+ - `clsx`
26
+ - `matter-js`
27
+ - `react`
28
+ - `react-dom`
29
+ - `tailwind-merge`
30
+
31
+ ## Usage
32
+
33
+ ```tsx
34
+ "use client";
35
+
36
+ import { AshBurstButton } from "@/components/buttons/ash-burst-button";
37
+
38
+ export function AshBurstButtonDemo() {
39
+ return (
40
+ <div className="flex items-center justify-center p-6">
41
+ <AshBurstButton>Click Me</AshBurstButton>
42
+ </div>
43
+ );
44
+ }
45
+ ```
46
+
47
+ ## API Reference
48
+
49
+ ### AshBurstButton
50
+
51
+ | Prop | Type | Default | Required | Description |
52
+ | :--- | :--- | :--- | :--- | :--- |
53
+ | `label` | `React.ReactNode` | — | No | Button label content |
54
+ | `particleCount` | `number` | 32 | No | Number of ash particles generated per burst |
55
+ | `className` | `string` | — | No | Additional CSS classes |
@@ -0,0 +1,52 @@
1
+ ---
2
+ title: "Brutal Button"
3
+ description: "Neo-brutalism button with stark borders, solid drop shadows, and high-contrast tactile depression."
4
+ category: "Components"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/craft/brutal-button.md"
8
+ markdown: "references/craft/brutal-button.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Brutal Button
13
+
14
+ > Neo-brutalism button with stark borders, solid drop shadows, and high-contrast tactile depression.
15
+
16
+ ## Install
17
+
18
+ ```bash
19
+ # Install via motion-ui skill CLI:
20
+ python scripts/install-component.py brutal-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 { BrutalButton } from "@/components/buttons/brutal-button";
35
+
36
+ export function BrutalButtonDemo() {
37
+ return (
38
+ <div className="flex items-center justify-center p-6">
39
+ <BrutalButton>Click Me</BrutalButton>
40
+ </div>
41
+ );
42
+ }
43
+ ```
44
+
45
+ ## API Reference
46
+
47
+ ### BrutalButton
48
+
49
+ | Prop | Type | Default | Required | Description |
50
+ | :--- | :--- | :--- | :--- | :--- |
51
+ | `className` | `string` | — | No | Additional CSS classes |
52
+ | `children` | `React.ReactNode` | — | No | Button label or icon content |
@@ -0,0 +1,53 @@
1
+ ---
2
+ title: "Chrome Button"
3
+ description: "Metallic pill button whose border is a ring of flowing liquid chrome reflection around a solid face."
4
+ category: "Components"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/craft/chrome-button.md"
8
+ markdown: "references/craft/chrome-button.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Chrome Button
13
+
14
+ > Metallic pill button whose border is a ring of flowing liquid chrome reflection around a solid face.
15
+
16
+ ## Install
17
+
18
+ ```bash
19
+ # Install via motion-ui skill CLI:
20
+ python scripts/install-component.py chrome-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 { ChromeButton } from "@/components/buttons/chrome-button";
35
+
36
+ export function ChromeButtonDemo() {
37
+ return (
38
+ <div className="flex items-center justify-center p-6">
39
+ <ChromeButton>Click Me</ChromeButton>
40
+ </div>
41
+ );
42
+ }
43
+ ```
44
+
45
+ ## API Reference
46
+
47
+ ### ChromeButton
48
+
49
+ | Prop | Type | Default | Required | Description |
50
+ | :--- | :--- | :--- | :--- | :--- |
51
+ | `size` | `"default" | "compact" | "icon"` | "default" | No | Button dimensions and padding scale |
52
+ | `className` | `string` | — | No | Additional CSS classes |
53
+ | `children` | `React.ReactNode` | — | No | Button label content |
@@ -0,0 +1,53 @@
1
+ ---
2
+ title: "Click Power-Up"
3
+ description: "Bracketed button that arms on hover and powers up with an accent flash and bracket burst on every click."
4
+ category: "Components"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/craft/click-powerup.md"
8
+ markdown: "references/craft/click-powerup.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Click Power-Up
13
+
14
+ > Bracketed button that arms on hover and powers up with an accent flash and bracket burst on every click.
15
+
16
+ ## Install
17
+
18
+ ```bash
19
+ # Install via motion-ui skill CLI:
20
+ python scripts/install-component.py click-powerup --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 { ClickPowerUp } from "@/components/buttons/click-powerup";
36
+
37
+ export function ClickPowerUpDemo() {
38
+ return (
39
+ <div className="flex items-center justify-center p-6">
40
+ <ClickPowerUp>Click Me</ClickPowerUp>
41
+ </div>
42
+ );
43
+ }
44
+ ```
45
+
46
+ ## API Reference
47
+
48
+ ### ClickPowerUp
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: "Command Button"
3
+ description: "Interactive command button with live shortcut key badge and mechanical key switch feedback."
4
+ category: "Components"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/craft/command-button.md"
8
+ markdown: "references/craft/command-button.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Command Button
13
+
14
+ > Interactive command button with live shortcut key badge and mechanical key switch feedback.
15
+
16
+ ## Install
17
+
18
+ ```bash
19
+ # Install via motion-ui skill CLI:
20
+ python scripts/install-component.py command-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 { CommandButton } from "@/components/buttons/command-button";
35
+
36
+ export function CommandButtonDemo() {
37
+ return (
38
+ <div className="flex items-center justify-center p-6">
39
+ <CommandButton>Click Me</CommandButton>
40
+ </div>
41
+ );
42
+ }
43
+ ```
44
+
45
+ ## API Reference
46
+
47
+ ### CommandButton
48
+
49
+ | Prop | Type | Default | Required | Description |
50
+ | :--- | :--- | :--- | :--- | :--- |
51
+ | `shortcut` | `string` | "⌘K" | No | Keyboard shortcut modifier string |
52
+ | `className` | `string` | — | No | Additional CSS classes |
53
+ | `children` | `React.ReactNode` | — | No | Button label content |
@@ -0,0 +1,54 @@
1
+ ---
2
+ title: "Confetti Button"
3
+ description: "Ringed dark button that triggers a celebratory canvas confetti burst with radial particle trajectories."
4
+ category: "Components"
5
+ publishedAt: "2026-10-21"
6
+ updatedAt: "2026-10-21"
7
+ documentation: "references/craft/confetti-button.md"
8
+ markdown: "references/craft/confetti-button.md"
9
+ license: "MIT"
10
+ ---
11
+
12
+ # Confetti Button
13
+
14
+ > Ringed dark button that triggers a celebratory canvas confetti burst with radial particle trajectories.
15
+
16
+ ## Install
17
+
18
+ ```bash
19
+ # Install via motion-ui skill CLI:
20
+ python scripts/install-component.py confetti-button --dest ./src
21
+ ```
22
+
23
+ ## Dependencies
24
+
25
+ - `canvas-confetti`
26
+ - `clsx`
27
+ - `react`
28
+ - `tailwind-merge`
29
+
30
+ ## Usage
31
+
32
+ ```tsx
33
+ "use client";
34
+
35
+ import { ConfettiButton } from "@/components/buttons/confetti-button";
36
+
37
+ export function ConfettiButtonDemo() {
38
+ return (
39
+ <div className="flex items-center justify-center p-6">
40
+ <ConfettiButton>Click Me</ConfettiButton>
41
+ </div>
42
+ );
43
+ }
44
+ ```
45
+
46
+ ## API Reference
47
+
48
+ ### ConfettiButton
49
+
50
+ | Prop | Type | Default | Required | Description |
51
+ | :--- | :--- | :--- | :--- | :--- |
52
+ | `particleCount` | `number` | 50 | No | Number of celebratory particles |
53
+ | `spread` | `number` | 70 | No | Angular spread of the burst in degrees |
54
+ | `className` | `string` | — | No | Additional CSS classes |