https://github.com/vincevargadev/nuts_activity_indicator_flutter
Highly customizable activity indicator (spinner) for your Flutter apps based on the cupertino package.
https://github.com/vincevargadev/nuts_activity_indicator_flutter
app-development awesome cupertino dart flutter ios material mobile-development nuts-and-bolts
Last synced: 4 months ago
JSON representation
Highly customizable activity indicator (spinner) for your Flutter apps based on the cupertino package.
- Host: GitHub
- URL: https://github.com/vincevargadev/nuts_activity_indicator_flutter
- Owner: vincevargadev
- License: bsd-3-clause
- Created: 2019-07-03T18:31:52.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2022-11-18T21:30:46.000Z (over 3 years ago)
- Last Synced: 2025-10-13T14:03:27.806Z (7 months ago)
- Topics: app-development, awesome, cupertino, dart, flutter, ios, material, mobile-development, nuts-and-bolts
- Language: C++
- Homepage: https://pub.dev/packages/nuts_activity_indicator
- Size: 34.5 MB
- Stars: 4
- Watchers: 0
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# `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](https://api.flutter.dev/flutter/cupertino/cupertino-library.html)'s
[`CupertinoActivityIndicator`](https://api.flutter.dev/flutter/cupertino/CupertinoActivityIndicator-class.html) widget
and it offers greater customizability.
You can customize:
* the colors 🧡❤️
* the width, size and the number of tickers 📏
* the speed of the spinning 🏃♂️💨
[](https://pub.dev/packages/nuts_activity_indicator 'See nuts_activity_indicator package info on pub.dev') [](https://pub.dev/publishers/dartside.dev/packages) [](https://github.com/dartsidedev/nuts_activity_indicator 'Star me on GitHub!')
## Important links
* [Read the source code and **star the repo** on GitHub](https://github.com/dartsidedev/nuts_activity_indicator)
* [Open an issue on GitHub](https://github.com/dartsidedev/nuts_activity_indicator/issues)
* [See package on pub.dev](https://pub.dev/packages/nuts_activity_indicator)
* [Read the docs on pub.dev](https://pub.dev/documentation/nuts_activity_indicator/latest/)
**If you enjoy using this package, a thumbs-up on [pub.dev](https://pub.dev/packages/nuts_activity_indicator) would be highly appreciated! 👍💙**
## Usage
```dart
// 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](https://developer.apple.com/design/human-interface-guidelines/ios/controls/progress-indicators/#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
* [Flutter `cupertino` library `CupertinoActivityIndicator` class](https://api.flutter.dev/flutter/cupertino/CupertinoActivityIndicator-class.html)
* [Apple Human Interface Guidelines on Activity Indicators](https://developer.apple.com/design/human-interface-guidelines/ios/controls/progress-indicators/#activity-indicators)
[Read the API reference](https://pub.dev/documentation/nuts_activity_indicator) to see all currently supported parameters.