Skip to content

Highly customizable activity indicator (spinner) for your Flutter apps based on the cupertino package.

License

Notifications You must be signed in to change notification settings

dartsidedev/nuts_activity_indicator

Repository files navigation

nuts_activity_indicator

Highly customizable activity indicator (spinner) for your Flutter apps based on the cupertino package.

The nuts_activity_indicator package is based on the cupertino library's CupertinoActivityIndicator widget and it offers greater customizability.

You can customize:

  • the colors 🧡❤️
  • the width, size and the number of tickers 📏
  • the speed of the spinning 🏃‍♂️💨

nuts_activity_indicator Published by dartside.dev GitHub Stars Count

Flutter package nuts_activity_indicator

Important links

If you enjoy using this package, a thumbs-up on pub.dev would be highly appreciated! 👍💙

Usage

// Add nuts_activity_indicator as dependency in your pubspec:
// $ flutter pub add nuts_activity_indicator

// Then, import the package:
import 'package:nuts_activity_indicator/nuts_activity_indicator.dart';

// And finally, use and customize the widget:
final spinner = NutsActivityIndicator(
    activeColor: Colors.indigo,
    inactiveColor: Colors.blueGrey,
    tickCount: 24,
    relativeWidth: 0.4,
    radius: 60,
    startRatio: 0.7,
    animationDuration: Duration(milliseconds: 500),
);

This package exports a highly customizable activity indicator, "spinner" widget based on the iOS-style activity indicator from the cupertino package.

The key takeaways from Apple Human Interface Guidelines on Activity Indicators that are also relevant to the NutsActivityIndicator class are:

  • use the activity indicator only when the task cannot be quantified (there is no known remaining time, task count, data size).
  • keep it moving: only disable animating if the process stalls.

For more information, see

Read the API reference to see all currently supported parameters.