atmospheric_particles 0.0.3

Enhance your Flutter application's visual appeal with atmospheric particle effects. This package provides a simple, performant way to layer subtle, moving particles onto your widgets, transforming sta [...]

atmospheric_particles

A lightweight, highly customizable Flutter package for creating beautiful particle animations in the background of any widget.

---

---

Features

• Highly Customizable: Control particle color, size, count, and speed.
• Directional Control: Set minimum and maximum velocities for both horizontal and vertical axes.
• Lightweight: Simple and efficient, designed to wrap any widget without performance issues.
• Easy to Use: Get started immediately with beautiful default parameters.

Getting Started

1. Installation

Add the package to your pubspec.yaml file:

dependencies:
  atmospheric_particles: ^0.0.1 

Or, run this command in your terminal:

flutter pub add atmospheric_particles

2. Import

Import the package into your Dart file:

import 'package:atmospheric_particles/atmospheric_particles.dart';

Usage

The AtmosphericParticles widget can be wrapped around any widget. It works best inside a SizedBox or Container to give it explicit dimensions.

Basic Example

This will create a particle field using the beautiful default parameters.

SizedBox(
  height: 200,
  width: double.infinity,
  child: AtmosphericParticles(
    child: Center(
      child: Text(
        'Hello Particles!',
        style: TextStyle(fontSize: 24, color: Colors.white),
      ),
    ),
  ),
)

Advanced Customization Example

You can customize nearly every aspect of the particle field.

List<Color> colors = [
  Colors.red,
  Colors.orange,
  Colors.yellow.shade600,
  Colors.green,
  Colors.blue,
  Colors.deepPurple,
  Colors.purple,
];

// ... inside your build method
for(int i = 0; i < 10; i++)
    SizedBox(
        height: 50,
        width: double.infinity,
        child: AtmosphericParticles(
            particleColor: colors[i % colors.length],
            particleRadius: 3,
            particleCount: 100,
            minVerticalVelocity: -30,
            maxVerticalVelocity: -10,
            minHorizontalVelocity: -30,
            maxHorizontalVelocity: -10,
            child: const Center(child: Text('Customized Particles')),
        ),
    ),

Widget Properties (API)

Property	Type	Description
child	Widget	The widget to display in front of the particle field.
particleColor	Color	The color of the particles. Defaults to Colors.purple with opacity.
particleCount	int	The total number of particles to render. Defaults to 200.
particleRadius	double	The radius of each particle. Defaults to 2.
minVerticalVelocity	double	The minimum upward speed. (Use negative values for upward motion). Defaults to -100.
maxVerticalVelocity	double	The maximum upward speed. (Use negative values for upward motion). Defaults to -20.
minHorizontalVelocity	double	The minimum horizontal speed. (Negative for left, positive for right). Defaults to 10.
maxHorizontalVelocity	double	The maximum horizontal speed. (Negative for left, positive for right). Defaults to 30.

Additional Information

Have Suggestions or Find a Bug?

If you have any suggestions or encounter a bug, we'd love to hear from you!

• Visit the GitHub Repository: For the source code, to see existing issues, or to learn more about the project: atmospheric_particles on GitHub
• Open an Issue on GitHub: This is the preferred method for tracking bugs and feature requests.
• Email me at [e-mail]

License

This package is licensed under the The 3-Clause BSD License.