frontend-magic-ui
Polished SaaS landing page components. Use for number tickers/stats animations, logo marquees, bento grids, device mockups (iPhone, Safari), shimmer/rainbow buttons, typing effects. Professional marketing polish built on Framer Motion + Tailwind. For dramatic hero effects use Aceternity, for basic UI use shadcn.
When & Why to Use This Skill
The Magic UI skill empowers developers to build stunning, high-performance SaaS landing pages using a library of 150+ animated React components. Leveraging the power of Framer Motion and Tailwind CSS, this tool provides ready-to-use code for sophisticated UI elements such as bento grids, logo marquees, and interactive device mockups. It is the ideal solution for adding professional marketing polish and dynamic visual effects to modern web applications, significantly reducing the time required to implement complex frontend animations.
Use Cases
- SaaS Landing Pages: Rapidly creating high-converting hero sections with animated text, shimmer buttons, and professional 'marketing polish'.
- Social Proof & Stats: Implementing dynamic number tickers for user growth statistics and infinite scrolling marquees for partner logo walls.
- Feature Showcases: Utilizing bento grid layouts and realistic iPhone/Safari device mockups to display product features in a modern, visually engaging way.
- Interactive Visualizations: Building complex integration diagrams or workflow visualizations using animated beams, orbiting circles, and particle patterns.
| name | frontend-magic-ui |
|---|---|
| description | Polished SaaS landing page components. Use for number tickers/stats animations, logo marquees, bento grids, device mockups (iPhone, Safari), shimmer/rainbow buttons, typing effects. Professional marketing polish built on Framer Motion + Tailwind. For dramatic hero effects use Aceternity, for basic UI use shadcn. |
| allowed-tools | Read, Edit, Write, Bash (*) |
Magic UI
150+ animated components for SaaS landing pages. Professional polish, production-ready.
When to Use
- Number/stat animations (tickers, counters)
- Logo walls (marquee)
- Bento grid layouts
- Device mockups (iPhone, Safari)
- Text animations (typing, word rotate)
- Shimmer/rainbow buttons
When NOT to Use
- Basic UI → shadcn/ui
- Dramatic hero effects → Aceternity
- State-driven animations → Rive
Process
NEED → ADD → CUSTOMIZE
- Identify component type
- Install:
npx magicui-cli@latest add [component] - Customize props/styles
Dependencies
npm install framer-motion clsx tailwind-merge
Component Categories
Text: number-ticker, typing-animation, word-rotate, flip-text, morphing-text
Buttons: shimmer-button, rainbow-button, pulsating-button, shiny-button
Patterns: dot-pattern, grid-pattern, retro-grid, particles, meteors
Mockups: iphone-15-pro, safari, android
Layout: bento-grid, marquee, dock, animated-list, file-tree
Effects: orbiting-circles, animated-beam, border-beam, confetti, globe
Decision Tree
Need animated component?
├─ Stats/numbers → number-ticker
├─ Logo carousel → marquee
├─ Feature grid → bento-grid
├─ CTA button → shimmer-button, rainbow-button
├─ App screenshot → safari, iphone-15-pro
├─ Dynamic headline → word-rotate, typing-animation
└─ Integration diagram → orbiting-circles, animated-beam
Quick Patterns
// Number Ticker
<div className="flex gap-12">
<NumberTicker value={10000} className="text-4xl font-bold" />
<span className="text-4xl">+</span>
</div>
// Marquee (logo wall)
<Marquee pauseOnHover className="[--duration:20s]">
{logos.map(logo => <img key={logo.name} src={logo.img} />)}
</Marquee>
// Word Rotate
<h1>Build <WordRotate words={["faster", "better"]} /> apps</h1>
// Safari Mockup
<Safari url="yourapp.com" src="/screenshot.png" />
Customization
// Speed via CSS variables
<Marquee className="[--duration:40s]">...</Marquee>
<NumberTicker className="[--duration:3s]" value={1000} />
// Colors
<ShimmerButton
shimmerColor="#a855f7"
background="linear-gradient(to right, #6366f1, #8b5cf6)"
>
Custom
</ShimmerButton>
// Marquee gap
<Marquee className="[--gap:2rem]">...</Marquee>
SSR & Hydration
// Always 'use client'
'use client'
// Heavy components: dynamic import
import dynamic from 'next/dynamic'
const Globe = dynamic(() => import('@/components/magicui/globe'), { ssr: false })
// Mounted check pattern
const [mounted, setMounted] = useState(false)
useEffect(() => setMounted(true), [])
if (!mounted) return <Skeleton />
Magic UI vs Aceternity
| Use Case | Magic UI | Aceternity |
|---|---|---|
| Number animation | ✓ NumberTicker | ✗ |
| Logo carousel | ✓ Marquee | ✓ InfiniteMovingCards |
| Hero spotlight | ✗ | ✓ Spotlight |
| Device mockup | ✓ Safari/iPhone | ✗ |
| 3D card tilt | ✗ | ✓ 3D Card |
Rule: Magic UI = polished SaaS, Aceternity = dramatic effects
Troubleshooting
"Component not found":
→ npx magicui-cli@latest add [name]
→ Check components/magicui/[name].tsx
"Animation not playing":
→ Add 'use client'
→ Check framer-motion installed
"Hydration mismatch":
→ dynamic(() => ..., { ssr: false })
"Marquee stuttering":
→ Increase [--duration:Xs]
→ Use pauseOnHover
References
- components.md — Full component API with all props
External Resources
- https://magicui.design/docs — Documentation
- For latest API → use context7 skill