Search packages, repositories and app categories

square_progress_indicator cover
Package detailsv0.0.8

square_progress_indicator

You can create customizable square progress indicators like native flutter CircularProgressIndicator widget.

AndroidiOSWebmacOSWindowsLinux
30-day downloads
5.3K
Likes
30
Pub points
160

Install package

flutter pub add square_progress_indicator

Package Overview

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

A customizable square-shaped progress indicator widget for Flutter, inspired by the native CircularProgressIndicator. It offers a modern, compact alternative to circular progress indicators with support for custom colors, stroke width, and animation. Ideal for loading states in apps where a square design fits better with the UI. The package is lightweight and compatible across all major platforms including Android, iOS, Web, macOS, Windows, and Linux.

Use cases

  • Loading indicators in forms
  • Displaying progress in dashboards
  • Custom loading animations in mobile apps
  • Replacing circular progress bars with square ones
  • Enhancing UI consistency in material design apps

Key features

  • Square-shaped design
  • Customizable color and stroke width
  • Smooth animation
  • Cross-platform compatibility
  • Simple integration with Flutter
  • Extensible styling options

Suitable for

  • Developers seeking alternative progress indicators
  • UI designers focusing on square-themed interfaces
  • Apps requiring consistent loading visuals
  • Flutter projects targeting multiple platforms
  • Projects using Material Design with modern aesthetics

Considerations

  • Limited to square geometry
  • May require additional styling for complex animations
  • Not suitable for circular progress needs
  • Depends on Flutter's rendering performance
  • Best used in contexts where square shapes align with design language

Original README

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

Create fully customizable square or rectangle progress indicators like native flutter CircularProgressIndicator widget!

Features

Full example of SquareProgressIndicator

Live demo

You can check the example project web export on this link: https://amir14a.github.io/square_progress_indicator/ Thanks to Github!❤️

Usage

Simple usage:

const SquareProgressIndicator(),

Customize usage:

SquareProgressIndicator(
    value: _value,
    width: 100,
    height: 100,
    borderRadius: 0,
    startPosition: StartPosition.leftCenter,
    strokeCap: StrokeCap.square,
    clockwise: true,
    color: Colors.purple,
    emptyStrokeColor: Colors.purple.withOpacity(.5),
    strokeWidth: 16,
    emptyStrokeWidth: 16,
    strokeAlign: SquareStrokeAlign.center,
    child: Text("${(_value * 100).toStringAsFixed(0)}%"),
),

Additional information

Parameter Type Default Info
value double? null The value of the progress, it should be between 0 and 1. don't pass it to use Indeterminate mode
width double 38 The width of rectangle that the progress line is drawn around it.
height double 38 The height of rectangle that the progress line is drawn around it.
borderRadius double 8 The border radius of the rectangle, it is applied to all four corners.
color Color? progressIndicatorTheme.color The color of the progress line.
emptyStrokeColor Color? progressIndicatorTheme.circularTrackColor The color of the line behind the progress line which show for reminding progress.
strokeWidth double 4 The width of the progress line.
emptyStrokeWidth double 4 The width of the line behind the progress line which show for reminding progress.
clockwise boolean true The direction of turn of progress line, if you pass false, the progress line will be reversed, default value is true.
startPosition double 0 (StartPosition.topCenter) Start position of progress line relative to the topCenter, you can pass a value from [StartPosition] class or custom double value you need.
strokeAlign SquareStrokeAlign SquareStrokeAlign.inside The stroke align of the progress line, pass a value from [SquareStrokeAlign] and read it's documents. see: https://api.flutter.dev/flutter/painting/BorderSide/strokeAlign.html
strokeCap StrokeCap? StrokeCap.round The stroke cap of the progress line and empty line, see: https://api.flutter.dev/flutter/dart-ui/StrokeCap.html
child Widget? null The child widget, it can be a text or everything you need.

Feel free to create issue or pull requests in github repository!

Categories

Source repository

Projects using this package