New: your coding agent can read the release notes before it upgrades. Set up the MCP server →
pub.dev
A lightweight and customizable Flutter package for creating beautiful particle animations and atmospheric effects in the background of any widget.
Last release 4 months ago
24 Apr 2026
Ships fairly regularly
a new release about every 3 months
Nearly every release is documented
notes for 18 of 18 stable releases
Nothing withdrawn
no release was ever pulled
10 months old
18 releases · first in 2025
One column per month.
Deprecated Color.value usage replaced with Color.toARGB32().
particleColor alpha is now respected when combined with fadeDirection. Previously the fade effect overwrote the color's own opacity; it now multiplies the two alphas so a semi-transparent color fades correctly.Color.value usage replaced with Color.toARGB32().FadeDirection enum values now clearly describe which edge becomes transparent and which stays opaque.Particle class and all its fields are now documented.trailLength parameter (removed in v0.4.0), fixed advanced example that referenced the removed particleRadius property, added missing childAlignment, width, and height entries to the API table, corrected particleColor description to mention alpha support.AlignmentGeometry type change.Removed Isolate for better performance.
Removed unused particle shape enum.
Added an interactive sandbox for particle customization.
Improved code style, formatting, and readability across the project.
particle_canvas.dart.README.md.A bug where the fade effect was not correctly applied to particle trails.
Refactor: Typed childAlignment as AlignmentGeometry (the Flutter base type for alignment values) to allow both Alignment and AlignmentDirectional to b
childAlignment as AlignmentGeometry (the Flutter base type for alignment values) to allow both Alignment and AlignmentDirectional to be passed.Refactored AtmosphericParticles to use default values for constructor parameters, improving maintainability.
AtmosphericParticles to use default values for constructor parameters, improving maintainability.AtmosphericParticles to prevent invalid parameter combinations.Breaking Change: Replaced particleRadius with minParticleRadius and maxParticleRadius in AtmosphericParticles.
minParticleRadius and maxParticleRadius properties to AtmosphericParticles to allow for particle size variation.particleRadius with minParticleRadius and maxParticleRadius in AtmosphericParticles.Added particleShape property to AtmosphericParticles to allow customization of particle shapes (circle, square, triangle, oval, rrect).
particleShape property to AtmosphericParticles to allow customization of particle shapes (circle, square, triangle, oval, rrect).Added trailLength property to AtmosphericParticles to enable and control the length of particle trails.
trailLength property to AtmosphericParticles to enable and control the length of particle trails.Added particlesInFront property to AtmosphericParticles to control whether particles are rendered in front of or behind the child widget.
particlesInFront property to AtmosphericParticles to control whether particles are rendered in front of or behind the child widget.Particle isolate test hanging due to improper shutdown handling.
ParticleCanvas using onExit port.lib/src directory for better project structure.Implemented isolate-based animation for improved performance.
AtmosphericParticles widget.ParticleCanvas to use a long-lived isolate for the animation logic.Breaking Change: Replaced the enableVerticalFade boolean property with the fadeDirection property to allow for more flexible fade effects.
FadeDirection enum (top, bottom, left, right, none) to control the direction of the particle opacity gradient.enableVerticalFade boolean property with the fadeDirection property to allow for more flexible fade effects.Added the repository field to pubspec.yaml to link directly to the GitHub source code.
repository field to pubspec.yaml to link directly to the GitHub source code.README.md file.description in pubspec.yaml to better explain the package's purpose.Added an `example/` folder containing a working demonstration.
example/ folder containing a working demonstration.Added AtmosphericParticles widget to easily add a particle effect background to any widget.
AtmosphericParticles widget to easily add a particle effect background to any widget.ParticleCanvas for managing particle state and animation loop.ParticlePainter for custom painting particles onto the canvas.particleColorparticleCountparticleRadiusminHorizontalVelocity / maxHorizontalVelocityminVerticalVelocity / maxVerticalVelocityenableVerticalFade option for a vertical "fade-in" opacity gradient.Your coding agent can read these notes before it upgrades. Set up the MCP server →