Search packages, repositories and app categories

water_bottle cover
Package detailsv0.0.8

water_bottle

This library add a bottle widget to your screen. You can use it as a loading indicator, a progress tracker, or any kind of measurement suits your needs.

AndroidiOSWebmacOSWindowsLinux
30-day downloads
30
Likes
42
Pub points
150

Install package

flutter pub add water_bottle

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

The water_bottle package provides a customizable bottle-shaped widget for Flutter applications. It can be used as a visually engaging loading indicator, progress tracker, or any other measurement visualization. The widget is designed to be intuitive and adaptable, making it ideal for displaying percentages, levels, or completion states in a fun and dynamic way. With support across all major platforms, it integrates seamlessly into apps targeting mobile, web, and desktop environments.

Use cases

  • Loading indicators
  • Progress tracking
  • Visualizing completion levels
  • Interactive UI elements
  • Data representation in dashboards

Key features

  • Bottle-shaped visual design
  • Customizable fill level
  • Cross-platform compatibility
  • Simple API integration
  • Supports animations

Suitable for

  • App developers seeking unique loading visuals
  • Designers wanting playful UI components
  • Projects requiring percentage-based progress displays
  • Educational or gamified applications
  • Dashboard and analytics interfaces

Considerations

  • Limited to visual representation only
  • Not suitable for complex data charts
  • May require styling adjustments for dark mode
  • Best suited for simple, linear progress
  • Performance impact with high-frequency updates

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

Water Bottle

Features

This library add a bottle widget to your screen. You can use it as a loading indicator, a progress tracker, or any kind of measurement suits your needs.

Plain Sphere Triangle

Sphere bottle get reduced to a ball when aspect ratio smaller than 1

Responsive Sphere

Usage

To use this library, add water_bottle as a dependency in your pubspec.yaml file.

Import it where you need

import 'package:water_bottle/water_bottle.dart';

Build bottle widget

final plainBottleRef = GlobalKey<WaterBottleState>();
WaterBottle(
    key: plainBottleRef, 
    waterColor: Colors.blue, 
    bottleColor: Colors.lightBlue,
    capColor: Colors.blueGrey
)

Update widget

plainBottleRef.currentState?.waterLevel = 0.5;// 0.0~1.0

For more please refer /example folder

Additional information

For more information, or contribution, please refer to the original github

Categories

Dependencies

Dependency list 1 items

Source repository

Projects using this package

No data available yet.