ParticlesBlob

ParticlesBlob is a customizable particle animation component for React. You can use it to create dynamic, visually appealing particle effects in your applications with minimal effort.

Features

• Customize particle size, amount, and animation duration
• Apply border radius, blur, and blend mode effects
• Use gradient or solid colors as background
• Lightweight and easy to integrate into any React project

Installation

To install the package, use npm or yarn:

NPM

npm install particles-blob

Yarn

yarn add particles-blob

Usage

Once installed, you can import and use the ParticlesBlob component in your project like this:

import React from 'react';
import ParticlesBlob from 'particles-blob';

const App: React.FC = () => {
  return (
    <div>
      <ParticlesBlob
        particleSize={200}
        animationDuration={5}
        amount={50}
        borderRadius={100}
        blur={0}
        blendMode="normal"
        backgroundColors="radial-gradient(63.62% 69.52% at 100% 0%, rgba(247, 214, 98, 0.8) 0%, rgba(247, 214, 98, 0.17) 52.08%, rgba(247, 214, 98, 0) 100%)"
      />
    </div>
  );
};

export default App;

Props

Here’s a list of all the props that can be passed to the ParticlesBlob component:

| Prop | Type | Description | Default Value | |---------------------|-----------|------------------------------------------------------------|---------------| | particleSize | number | Defines the size of particles. | 100 | | animationDuration | number | Sets the animation duration of particles (in seconds). | 5 | | amount | number | Specifies the number of particles. | 30 | | borderRadius | number | Controls the border radius of the particles. | 50 | | blur | number | Applies a blur effect to the particles. | 0 | | blendMode | string | Specifies the background blend mode for the particles. | "normal" | | backgroundColors | string | Sets the background color or gradient for the particles. | "" |

Example

import React from 'react';
import ParticlesBlob from 'particles-blob';

const Example = () => (
  <div>
    <ParticlesBlob
      particleSize={150}
      animationDuration={4}
      amount={40}
      borderRadius={75}
      blur={10}
      blendMode="multiply"
      backgroundColors="radial-gradient(circle, rgba(63,94,251,1) 0%, rgba(252,70,107,1) 100%)"
    />
  </div>
);

export default Example;

Customization

You can pass any valid CSS background value to the backgroundColors prop, including gradients, solid colors, or multiple backgrounds. Combine the effects of blur, borderRadius, and blendMode to create unique visual styles.

Blend Modes

The blendMode prop allows you to choose different background blend modes, such as:

• normal
• multiply
• screen
• overlay
• darken
• lighten
• color-dodge
• color-burn

Contributing

If you’d like to contribute to the development of ParticlesBlob, please feel free to submit a pull request or open an issue.

License

This project is licensed under the MIT License. See the LICENSE file for more details.