secondsky/claude-skills / plugins/motion/skills/motion
motion
VerifiedMotion (Framer Motion) React animation library. Use for drag-and-drop, scroll animations, gestures, SVG morphing, or encountering bundle size, complex transitions, spring physics errors.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 15.9 KB |
| references/accessibility-guide.md | markdown | 15.8 KB |
| references/common-patterns.md | markdown | 4.0 KB |
| references/core-concepts-deep-dive.md | markdown | 14.8 KB |
| references/motion-vs-auto-animate.md | markdown | 16.0 KB |
| references/nextjs-integration.md | markdown | 15.4 KB |
| references/performance-optimization.md | markdown | 18.6 KB |
| scripts/init-motion.shexecutable | script | 5.7 KB |
| scripts/optimize-bundle.shexecutable | script | 4.8 KB |
| templates/layout-transitions.tsx | other | 17.6 KB |
| templates/motion-nextjs-client.tsx | other | 12.6 KB |
| templates/motion-vite-basic.tsx | other | 9.1 KB |
| templates/scroll-parallax.tsx | other | 14.6 KB |
| templates/ui-components.tsx | other | 19.6 KB |
templates/ui-components.tsx
View on GitHub// Motion UI Components - Modal, Accordion, Carousel, Tabs
// Production-tested with Motion v12.43.0, React 19
/**
* INSTALLATION
*
* pnpm add motion
*
* USAGE
*
* Copy components below into your project.
* All components are production-ready and fully typed.
*
* For Next.js App Router, add "use client" directive at top of file.
*/
import { motion, AnimatePresence } from "motion/react"
import { useState, ReactNode, useRef } from "react"
// ============================================================================
// COMPONENT 1: Modal Dialog
// ============================================================================
interface ModalProps {
isOpen: boolean
onClose: () => void
title: string
children: ReactNode
}
export function Modal({ isOpen, onClose, title, children }: ModalProps) {
return (
<AnimatePresence>
{isOpen && (
<>
{/* Backdrop */}
<motion.div
key="backdrop"
initial={{ opacity: 0 }}
animate={{ opacity: 1 }}
exit={{ opacity: 0 }}
onClick={onClose}
className="fixed inset-0 bg-black/50 z-40 cursor-pointer"
/>
{/* Dialog */}
<motion.dialog
key="dialog"
initial={{ opacity: 0, scale: 0.9, y: 20 }}
animate={{ opacity: 1, scale: 1, y: 0 }}
exit={{ opacity: 0, scale: 0.9, y: 20 }}
transition={{ type: "spring", damping: 20, stiffness: 300 }}
className="fixed inset-0 m-auto w-full max-w-md h-fit bg-white dark:bg-gray-800 rounded-lg shadow-2xl z-50 p-6"
style={{ willChange: "transform, opacity" }}
>
{/* Header */}
<div className="flex justify-between items-center mb-4">
<h2 className="text-2xl font-bold">{title}</h2>
<motion.button
whileHover={{ scale: 1.1, rotate: 90 }}
whileTap={{ scale: 0.9 }}
onClick={onClose}
className="text-gray-500 hover:text-gray-700 dark:hover:text-gray-300 text-2xl"
>
✕
</motion.button>
</div>
{/* Content */}
<div className="text-gray-700 dark:text-gray-300">
{children}
</div>
{/* Footer */}
<div className="mt-6 flex justify-end gap-2">
<motion.button
whileHover={{ scale: 1.05 }}
whileTap={{ scale: 0.95 }}
onClick={onClose}
className="px-4 py-2 bg-gray-200 dark:bg-gray-700 rounded hover:bg-gray-300 dark:hover:bg-gray-600"
>
Close
</motion.button>
</div>
</motion.dialog>
</>
)}
</AnimatePresence>
)
}
/**
* USAGE
*
* function App() {
* const [isOpen, setIsOpen] = useState(false)
*
* return (
* <>
* <button onClick={() => setIsOpen(true)}>Open Modal</button>
* <Modal
* isOpen={isOpen}
* onClose={() => setIsOpen(false)}
* title="Welcome"
* >
* <p>Modal content goes here.</p>
* </Modal>
* </>
* )
* }
*/
// ============================================================================
// COMPONENT 2: Accordion
// ============================================================================
interface AccordionItemProps {
title: string
children: ReactNode
isOpen: boolean
onToggle: () => void
}
export function AccordionItem({ title, children, isOpen, onToggle }: AccordionItemProps) {
return (
<div className="border-b border-gray-200 dark:border-gray-700">
{/* Trigger */}
<motion.button
onClick={onToggle}
className="w-full flex justify-between items-center py-4 px-4 text-left hover:bg-gray-50 dark:hover:bg-gray-800"
whileHover={{ backgroundColor: "rgba(0, 0, 0, 0.02)" }}
>
<span className="font-semibold">{title}</span>
<motion.span
animate={{ rotate: isOpen ? 180 : 0 }}
transition={{ duration: 0.3 }}
>
▼
</motion.span>
</motion.button>
{/* Content */}
<motion.div
initial={false}
animate={{
height: isOpen ? "auto" : 0,
opacity: isOpen ? 1 : 0,
}}
transition={{ duration: 0.3 }}
style={{ overflow: "hidden" }}
>
<div className="p-4 text-gray-700 dark:text-gray-300">
{children}
</div>
</motion.div>
</div>
)
}
interface AccordionProps {
items: Array<{
id: string
title: string
content: ReactNode
}>
allowMultiple?: boolean
}
export function Accordion({ items, allowMultiple = false }: AccordionProps) {
const [openItems, setOpenItems] = useState<Set<string>>(new Set())
const handleToggle = (id: string) => {
setOpenItems((prev) => {
const next = new Set(prev)
if (next.has(id)) {
next.delete(id)
} else {
if (!allowMultiple) {
next.clear()
}
next.add(id)
}
return next
})
}
return (
<div className="border border-gray-200 dark:border-gray-700 rounded-lg overflow-hidden">
{items.map((item) => (
<AccordionItem
key={item.id}
title={item.title}
isOpen={openItems.has(item.id)}
onToggle={() => handleToggle(item.id)}
>
{item.content}
</AccordionItem>
))}
</div>
)
}
/**
* USAGE
*
* <Accordion
* allowMultiple={false}
* items={[
* { id: "1", title: "Section 1", content: <p>Content 1</p> },
* { id: "2", title: "Section 2", content: <p>Content 2</p> },
* ]}
* />
*/
// ============================================================================
// COMPONENT 3: Carousel / Image Slider
// ============================================================================
interface CarouselProps {
images: Array<{
id: string
url: string
alt: string
}>
}
export function Carousel({ images }: CarouselProps) {
const [currentIndex, setCurrentIndex] = useState(0)
const [direction, setDirection] = useState(0) // 1 = next, -1 = prev
const handleNext = () => {
setDirection(1)
setCurrentIndex((prev) => (prev + 1) % images.length)
}
const handlePrev = () => {
setDirection(-1)
setCurrentIndex((prev) => (prev - 1 + images.length) % images.length)
}
const variants = {
enter: (direction: number) => ({
x: direction > 0 ? 1000 : -1000,
opacity: 0,
}),
center: {
x: 0,
opacity: 1,
},
exit: (direction: number) => ({
x: direction < 0 ? 1000 : -1000,
opacity: 0,
}),
}
return (
<div className="relative w-full h-96 overflow-hidden bg-gray-100 dark:bg-gray-800 rounded-lg">
{/* Image */}
<AnimatePresence initial={false} custom={direction}>
<motion.img
key={currentIndex}
src={images[currentIndex].url}
alt={images[currentIndex].alt}
custom={direction}
variants={variants}
initial="enter"
animate="center"
exit="exit"
transition={{ type: "spring", stiffness: 300, damping: 30 }}
className="absolute inset-0 w-full h-full object-cover"
/>
</AnimatePresence>
{/* Navigation buttons */}
<button
onClick={handlePrev}
className="absolute left-4 top-1/2 -translate-y-1/2 bg-white/80 dark:bg-gray-800/80 p-3 rounded-full shadow-lg z-10"
>
←
</button>
<button
onClick={handleNext}
className="absolute right-4 top-1/2 -translate-y-1/2 bg-white/80 dark:bg-gray-800/80 p-3 rounded-full shadow-lg z-10"
>
→
</button>
{/* Indicators */}
<div className="absolute bottom-4 left-1/2 -translate-x-1/2 flex gap-2 z-10">
{images.map((_, index) => (
<motion.button
key={index}
onClick={() => {
setDirection(index > currentIndex ? 1 : -1)
setCurrentIndex(index)
}}
animate={{
scale: index === currentIndex ? 1.2 : 1,
opacity: index === currentIndex ? 1 : 0.5,
}}
className="w-3 h-3 bg-white rounded-full"
/>
))}
</div>
</div>
)
}
/**
* USAGE
*
* <Carousel
* images={[
* { id: "1", url: "/image1.jpg", alt: "Image 1" },
* { id: "2", url: "/image2.jpg", alt: "Image 2" },
* ]}
* />
*/
// ============================================================================
// COMPONENT 4: Drag-to-Scroll Carousel (Alternative)
// ============================================================================
interface DragCarouselProps {
items: ReactNode[]
}
export function DragCarousel({ items }: DragCarouselProps) {
const constraintsRef = useRef<HTMLDivElement>(null)
return (
<div
ref={constraintsRef}
className="overflow-hidden bg-gray-100 dark:bg-gray-800 rounded-lg p-4"
>
<motion.div
drag="x"
dragConstraints={constraintsRef}
dragElastic={0.1}
dragMomentum={false}
className="flex gap-4 cursor-grab active:cursor-grabbing"
>
{items.map((item, index) => (
<motion.div
key={index}
whileHover={{ scale: 1.05 }}
className="min-w-[300px] h-64 bg-white dark:bg-gray-700 rounded-lg shadow-md flex items-center justify-center"
>
{item}
</motion.div>
))}
</motion.div>
</div>
)
}
/**
* USAGE
*
* <DragCarousel
* items={[
* <div>Card 1</div>,
* <div>Card 2</div>,
* <div>Card 3</div>,
* ]}
* />
*/
// ============================================================================
// COMPONENT 5: Tabs with Shared Underline (layoutId)
// ============================================================================
interface Tab {
id: string
label: string
content: ReactNode
}
interface TabsProps {
tabs: Tab[]
}
export function Tabs({ tabs }: TabsProps) {
const [activeTab, setActiveTab] = useState(tabs[0].id)
return (
<div>
{/* Tab buttons */}
<div className="flex gap-4 border-b border-gray-200 dark:border-gray-700">
{tabs.map((tab) => (
<button
key={tab.id}
onClick={() => setActiveTab(tab.id)}
className="relative px-4 py-2 text-gray-700 dark:text-gray-300 hover:text-gray-900 dark:hover:text-white"
>
{tab.label}
{/* Shared underline */}
{activeTab === tab.id && (
<motion.div
layoutId="activeTab"
className="absolute bottom-0 left-0 right-0 h-0.5 bg-blue-600"
transition={{ type: "spring", stiffness: 300, damping: 30 }}
/>
)}
</button>
))}
</div>
{/* Tab content */}
<AnimatePresence mode="wait">
<motion.div
key={activeTab}
initial={{ opacity: 0, y: 10 }}
animate={{ opacity: 1, y: 0 }}
exit={{ opacity: 0, y: -10 }}
transition={{ duration: 0.2 }}
className="p-4"
>
{tabs.find((tab) => tab.id === activeTab)?.content}
</motion.div>
</AnimatePresence>
</div>
)
}
/**
* USAGE
*
* <Tabs
* tabs={[
* { id: "1", label: "Home", content: <p>Home content</p> },
* { id: "2", label: "Profile", content: <p>Profile content</p> },
* { id: "3", label: "Settings", content: <p>Settings content</p> },
* ]}
* />
*/
// ============================================================================
// COMPONENT 6: Dropdown Menu
// ============================================================================
interface DropdownProps {
trigger: ReactNode
items: Array<{
label: string
onClick: () => void
}>
}
export function Dropdown({ trigger, items }: DropdownProps) {
const [isOpen, setIsOpen] = useState(false)
return (
<div className="relative">
{/* Trigger */}
<div onClick={() => setIsOpen(!isOpen)}>
{trigger}
</div>
{/* Menu */}
<AnimatePresence>
{isOpen && (
<>
{/* Backdrop to close on click outside */}
<div
className="fixed inset-0 z-10"
onClick={() => setIsOpen(false)}
/>
{/* Dropdown */}
<motion.div
initial={{ opacity: 0, y: -10 }}
animate={{ opacity: 1, y: 0 }}
exit={{ opacity: 0, y: -10 }}
transition={{ duration: 0.2 }}
className="absolute right-0 mt-2 w-48 bg-white dark:bg-gray-800 border border-gray-200 dark:border-gray-700 rounded-lg shadow-lg z-20"
>
{items.map((item, index) => (
<motion.button
key={index}
whileHover={{ backgroundColor: "rgba(0, 0, 0, 0.05)" }}
onClick={() => {
item.onClick()
setIsOpen(false)
}}
className="w-full text-left px-4 py-2 first:rounded-t-lg last:rounded-b-lg"
>
{item.label}
</motion.button>
))}
</motion.div>
</>
)}
</AnimatePresence>
</div>
)
}
/**
* USAGE
*
* <Dropdown
* trigger={<button>Open Menu</button>}
* items={[
* { label: "Profile", onClick: () => console.log("Profile") },
* { label: "Settings", onClick: () => console.log("Settings") },
* { label: "Logout", onClick: () => console.log("Logout") },
* ]}
* />
*/
// ============================================================================
// COMPONENT 7: Toast Notification
// ============================================================================
interface ToastProps {
message: string
type?: "success" | "error" | "info"
isVisible: boolean
onClose: () => void
}
export function Toast({ message, type = "info", isVisible, onClose }: ToastProps) {
const colors = {
success: "bg-green-500",
error: "bg-red-500",
info: "bg-blue-500",
}
return (
<AnimatePresence>
{isVisible && (
<motion.div
initial={{ opacity: 0, x: 300 }}
animate={{ opacity: 1, x: 0 }}
exit={{ opacity: 0, x: 300 }}
transition={{ type: "spring", stiffness: 300, damping: 30 }}
className={`fixed top-4 right-4 ${colors[type]} text-white px-6 py-4 rounded-lg shadow-lg z-50 flex items-center gap-4`}
>
<span>{message}</span>
<motion.button
whileHover={{ scale: 1.1 }}
whileTap={{ scale: 0.9 }}
onClick={onClose}
className="text-white/80 hover:text-white"
>
✕
</motion.button>
</motion.div>
)}
</AnimatePresence>
)
}
/**
* USAGE
*
* function App() {
* const [showToast, setShowToast] = useState(false)
*
* return (
* <>
* <button onClick={() => setShowToast(true)}>Show Toast</button>
* <Toast
* message="Action completed!"
* type="success"
* isVisible={showToast}
* onClose={() => setShowToast(false)}
* />
* </>
* )
* }
*/
// ============================================================================
// ALL COMPONENTS DEMO
// ============================================================================
export function UIComponentsDemo() {
const [isModalOpen, setIsModalOpen] = useState(false)
const [showToast, setShowToast] = useState(false)
return (
<div className="max-w-4xl mx-auto p-8 space-y-12">
<h1 className="text-4xl font-bold mb-8">Motion UI Components</h1>
{/* Modal */}
<section>
<h2 className="text-2xl font-bold mb-4">1. Modal Dialog</h2>
<button
onClick={() => setIsModalOpen(true)}
className="px-4 py-2 bg-blue-600 text-white rounded"
>
Open Modal
</button>
<Modal
isOpen={isModalOpen}
onClose={() => setIsModalOpen(false)}
title="Example Modal"
>
<p>This is a modal with smooth animations.</p>
</Modal>
</section>
{/* Accordion */}
<section>
<h2 className="text-2xl font-bold mb-4">2. Accordion</h2>
<Accordion
items={[
{ id: "1", title: "Section 1", content: <p>Content for section 1</p> },
{ id: "2", title: "Section 2", content: <p>Content for section 2</p> },
{ id: "3", title: "Section 3", content: <p>Content for section 3</p> },
]}
/>
</section>
{/* Carousel */}
<section>
<h2 className="text-2xl font-bold mb-4">3. Carousel</h2>
<Carousel
images={[
{ id: "1", url: "https://via.placeholder.com/800x400/ff6b6b", alt: "Red" },
{ id: "2", url: "https://via.placeholder.com/800x400/4ecdc4", alt: "Teal" },
{ id: "3", url: "https://via.placeholder.com/800x400/ffe66d", alt: "Yellow" },
]}
/>
</section>
{/* Drag Carousel */}
<section>
<h2 className="text-2xl font-bold mb-4">4. Drag Carousel</h2>
<DragCarousel
items={[
<div className="text-2xl font-bold">Card 1</div>,
<div className="text-2xl font-bold">Card 2</div>,
<div className="text-2xl font-bold">Card 3</div>,
<div className="text-2xl font-bold">Card 4</div>,
]}
/>
</section>
{/* Tabs */}
<section>
<h2 className="text-2xl font-bold mb-4">5. Tabs</h2>
<Tabs
tabs={[
{ id: "home", label: "Home", content: <p>Home tab content</p> },
{ id: "profile", label: "Profile", content: <p>Profile tab content</p> },
{ id: "settings", label: "Settings", content: <p>Settings tab content</p> },
]}
/>
</section>
{/* Dropdown */}
<section>
<h2 className="text-2xl font-bold mb-4">6. Dropdown Menu</h2>
<Dropdown
trigger={
<button className="px-4 py-2 bg-gray-600 text-white rounded">
Open Menu
</button>
}
items={[
{ label: "Profile", onClick: () => alert("Profile clicked") },
{ label: "Settings", onClick: () => alert("Settings clicked") },
{ label: "Logout", onClick: () => alert("Logout clicked") },
]}
/>
</section>
{/* Toast */}
<section>
<h2 className="text-2xl font-bold mb-4">7. Toast Notification</h2>
<button
onClick={() => setShowToast(true)}
className="px-4 py-2 bg-green-600 text-white rounded"
>
Show Toast
</button>
<Toast
message="Success! Action completed."
type="success"
isVisible={showToast}
onClose={() => setShowToast(false)}
/>
</section>
</div>
)
}
/**
* PERFORMANCE TIPS
*
* 1. Add willChange for transforms:
* style={{ willChange: "transform, opacity" }}
*
* 2. Use AnimatePresence mode="wait" for sequential animations
*
* 3. For large lists in carousels, use virtualization:
* pnpm add react-window
*
* See ../references/performance-optimization.md for full guide
*/
/**
* ACCESSIBILITY TIPS
*
* 1. Add keyboard support:
* - Escape to close modals
* - Arrow keys for carousels
* - Enter/Space for accordion triggers
*
* 2. Add ARIA attributes:
* - aria-expanded for accordions
* - aria-hidden for modals
* - role="dialog" for modals
*
* 3. Respect prefers-reduced-motion:
* <MotionConfig reducedMotion="user">
* <UIComponentsDemo />
* </MotionConfig>
*/
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |