Skip to Content
✨ Just dropped my UI Library — still cooking up some magic! Stay tuned & maybe… hire me  or sponsor me 😉 
DocumentationParticle Background

Particle Background

An animated background component that creates floating particles with customizable colors, speed, and appearance. Perfect for adding dynamic visual interest to landing pages, hero sections, or any area needing ambient animation.

Install Dependencies

npx
quickcode-ui add ParticleBackground

Default Usage

Particle Background

Beautiful Particle Animation

Animated background particles that create a dynamic and engaging visual experience

Custom Colors and Settings

Custom Colors & Speed

Customized Particles

Warm colors, fast movement, larger size, no blur

Props

PropTypeDefaultDescription
particleCountnumber50Number of particles to render
colorsstring[]["#06b6d4", "#a855f7", "#ec4899"]Array of hex colors for particles
speed"slow" | "medium" | "fast""medium"Animation speed of particle movement
size"sm" | "md" | "lg""md"Size of individual particles
blurbooleantrueWhether to apply blur effect to particles
fixedbooleantrueUse fixed positioning (viewport) or absolute (container)

Features

  • Customizable Particles: Control count, colors, size, and blur effects
  • Variable Speed: Choose from slow, medium, or fast animation speeds
  • Fixed Positioning: Automatically positions behind content with proper z-index
  • Performance Optimized: Efficient animations using Framer Motion
  • Responsive: Works seamlessly across all screen sizes
  • Theme Compatible: Uses bg-background for proper theme support

Real-World Usage

This component is ideal for creating engaging hero sections, landing page backgrounds, or adding subtle animation to dashboard layouts. The fixed positioning ensures it stays in the background while content remains interactive and accessible. Commonly used in SaaS landing pages, portfolio sites, and modern web applications to create depth and visual interest without overwhelming the main content.

Last updated on