PackageTrack
Sign in Get early access

aqua_bottle

A 60fps reactive water wave ripple physics & aquatic simulation background package for Flutter with 12 realistic fish species and marine creatures.

1.2.9 aswinbbc/aqua

What this package is like to depend on

Last release 1 months ago

24 Jul 2026

Too new to tell

only 1 release windows

Nearly every release is documented

notes for 16 of 16 stable releases

4 versions withdrawn

withdrawn after publishing

1 months old

20 releases · first in 2026

20 releases in the last 12 months

see the full history below

Release timeline

20 releases · Jul 2026 to Jul 2026
Release Pre-release Withdrawn

Releases

latest 20
  1. 1.2.9 24 Jul 2026
    Release notes
    • Added creature separation logic and collision boundaries inside the behavior engine. This gently steers same-species creatures (like jellyfish) away from each other when they overlap, preventing the double jellyfish overlap glitch.
    Open source →
  2. 1.2.6 22 Jul 2026
    Release notes
    • Implemented strict circular orbit locking for all fishes and creatures once they arrive on the loading spinner. This eliminates overshoot-correction feedback loops that caused goldfish jittering and guppies spinning/rotating.
    Open source →
  3. 1.2.5 22 Jul 2026
    Release notes
    • Calibrated loading-state wiggling speed (to 2.4x) and body wave amplitude multiplier (to 0.32x) to match slow, elegant circle gliding speed and prevent any unnatural fast vibrations.
    Open source →
  4. 1.2.4 22 Jul 2026
    Release notes
    • Refined fish tail and fin wiggling speeds during the loading state, smoothing out frantic high-frequency wiggles to create a gentle, realistic swim flow.
    • Optimized creature release sequence: non-fish creatures no longer wait for the entire parade of fish to align. As soon as a creature aligns on its parade spot, it immediately breaks away and joins the circle spinner.
    Open source →
  5. 1.2.3 22 Jul 2026
    Release notes
    • Coordinated both fish and non-fish marine creatures to participate in the loading spinner sequences.
    • Structured loading into two global steps: first all objects swim rapidly to align on a horizontal parade line, face right, and idle until all have arrived. Once aligned, they start entering the orbit circle sequentially one after another.
    • Arranged all participating objects to orbit in a single shared circle maintaining perfectly equal distances along its perimeter, which does not vary in radius or shape based on the population size.
    Open source →
  6. 1.2.2 22 Jul 2026
    Release notes
    • Implemented a two-stage animation sequence during loading: fish first swim to align on a single evenly-spaced horizontal center line before forming the rotating loading circle vortex.
    • Increased the swimming speed of fish slightly (1.25x maximum speed) during the loading sequences for prompt alignment.
    Open source →
  7. 1.2.1 22 Jul 2026
    Release notes
    • Added startLoading() and stopLoading() capabilities to AquariumController. When loading is active, fish form a rotating loading circle spinner.
    • Added animated rising water bubbles physics simulation to the background with enableBubbles toggle configuration.
    Open source →
  8. 1.2.0 22 Jul 2026
    Release notes
    • Upgraded the populations configuration map to use strongly-typed Aquatic enum keys instead of dynamic strings (e.g. Aquatic.manta: 1).
    • Exported unified Aquatic enum containing all 18 fish and marine creature species under simple, clean naming conventions (e.g. guppy, betta, manta, turtle).
    Open source →
  9. 1.1.1 22 Jul 2026
    Release notes
    • Fixed performance hanging issues on mobile devices during multitouch or rapid swipe gestures.
    • Added pointer move distance-throttling (minimum 55px delta) and limited concurrent active ripples to 6 to keep render computations extremely lightweight.
    • Added enableSwipeRipples configuration switch to disable swipe-to-ripple gestures entirely if desired.
    Open source →
  10. 1.0.10 22 Jul 2026
    Release notes
    • Corrected README demo element to use standard Markdown image tags instead of HTML <video> tags for rendering compatibility on pub.dev.
    Open source →
  11. 1.0.9 22 Jul 2026
    Release notes
    • Removed google_fonts dependency from the package to prevent version conflicts with transitive dependencies (e.g. http) in parent projects.
    Open source →
  12. 1.0.8 22 Jul 2026
    Release notes
    • Fixed double-tap-to-feed gesture detection by adding a specialized translucent double-tap gesture interceptor on top of child app screens.
    Open source →
  13. 1.0.7 22 Jul 2026
    Release notes
    • Fixed reactive touch-to-ripple gesture detection when wrapping arbitrary child screens by placing the pointer listener on top of child layers using translucent hit-testing.
    Open source →
  14. 1.0.6 21 Jul 2026
    Release notes
    • Replaced README GIF demo with a high-clarity 60fps MP4 video demonstration for perfect color rendering and smooth playback.
    • Referenced raw GitHub URL for online markdown video autoplay support.
    Open source →
  15. 1.0.5 20 Jul 2026 withdrawn
    Release notes
    • Cropped README GIF preview to show only the web app browser window, removing surrounding macOS desktop environment.
    Open source →
  16. 1.0.4 20 Jul 2026 withdrawn
    Release notes
    • Replaced README GIF demo with a high-definition web browser simulation demonstration showing 60fps reactive water waves, feeding mechanisms, and creatures.
    Open source →
  17. 1.0.3 20 Jul 2026 withdrawn

    Nothing published for this version

  18. 1.0.2 20 Jul 2026 withdrawn
    Release notes
    • Optimized GIF demo size (858 KB) for fast loading & full pub.dev preview compatibility.
    • Updated raw GitHub raw URL for immediate image rendering on pub.dev package homepage.
    Open source →
  19. 1.0.1 20 Jul 2026
    Release notes
    • Fixed pub.dev README GIF preview link.
    • Updated repository and issue tracker URLs to https://github.com/aswinbbc/aqua.
    Open source →
  20. 1.0.0 20 Jul 2026
    Release notes
    • Initial release of aqua_bottle Flutter package.
    • 60fps reactive water wave ripple physics with optical refraction & splash particle generation.
    • 12 realistic fish species (Koi, Betta, Discus, Clownfish, Angelfish, Guppy, Blue Tang, Neon Tetra, Black Moor).
    • 6 non-fish marine creatures (Bioluminescent Jellyfish, Green Sea Turtle, Manta Ray, Seahorse, Starfish, Hermit Crab).
    • AquariumBackground reusable background widget with touch gesture ripple detection.
    • AquariumController for programmatically triggering wave ripples, food drops, themes, and fish population.
    • 4 aquatic water presets (Crystal Lagoon, Deep Ocean, Sunset Pond, Emerald Reef).
    • High quality animated GIF feature demo in README documentation.
    Open source →

Every package, every release, already written down.

The archive is open and free. Watching your own project is what we are building next.

Browse the archive