Search packages, repositories and app categories

ducafecatFlutter ecosystem guide
Package detailsv1.0.1

customgauge

Fully customizable Gauge widget for Flutter with options for multiple segments, colors and customizable styling for displaying current value and text

pub.dev API documentation Source code
30-day downloads
137
Likes
17
Pub points
40

Install package

flutter pub add customgauge

Package Overview

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

A highly customizable Gauge widget for Flutter that supports multiple segments, dynamic color schemes, and fully adjustable styling for both the gauge itself and its displayed value and text. Ideal for visualizing metrics such as progress, scores, or percentages with a polished, tailored appearance. The widget is designed for flexibility, allowing developers to define segment ranges, colors, and label formats to match app-specific needs. It integrates seamlessly into dashboards, health apps, or analytics interfaces.

Use cases

  • Displaying progress or performance metrics
  • Creating custom score indicators
  • Visualizing percentage-based data
  • Building dashboard widgets
  • Designing interactive gauges in analytics apps

Key features

  • Multiple customizable segments
  • Dynamic color configuration
  • Stylable value and text display
  • Support for custom ranges and labels
  • Highly flexible layout options
  • Extensible for animations and interactions

Suitable for

  • Developers building data visualization dashboards
  • Apps requiring branded or unique gauge designs
  • Projects needing progress or status indicators
  • UI designers seeking reusable, styled components
  • Flutter apps with metric-driven user interfaces

Considerations

  • Requires manual handling of animation if needed
  • Limited built-in support for touch interactions
  • No platform-specific optimizations mentioned
  • Best suited for static or simple animated values
  • May need additional code for complex logic or responsiveness

Original README

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

customgauge

Fully customizable Gauge widget for Flutter

Installing:

In your pubspec.yaml, add the following dependency

dependencies:
  customgauge: 1.0.0

Example Usage:

import 'package:customgauge/customgauge.dart';

CustomGauge(
    gaugeSize: 200,
    segments: [
        GaugeSegment('Low', 20, Colors.red),
        GaugeSegment('Medium', 40, Colors.orange),
        GaugeSegment('High', 40, Colors.green),
    ],
    currentValue: 46,
    displayWidget: Text('Fuel in tank', style: TextStyle(fontSize: 12)),
),

Features:

  • Fully featured Gauge widget that is built from scratch
  • Can have any number of segments in the Gauge with different segment length and colors
  • Gauge can have any dimension (square dimension only) with any minimum and maximum value
  • Needle color can be customized
  • Display and Value widget can be customized, so that you can display what you want on the Gauge
  • Can turn on/off markers that display Min and Max value on the Gauge. You can even style these markers!

License:

This project is licensed under the BSD 2-Clause license - see the LICENSE file for details

Categories

Plots & Visualization

Source repository

Projects using this package

No data available yet.