anka_super_loading_package

Five curated indeterminate loading animations for Flutter behind one small API: pick a LoadingStyle and drop in AnkaSuperLoading. The bundled example app is the quickest way to compare presets side by side, tune size / duration / color, and flip light / dark / system theme from the app bar—the captures below are all from that app (iOS Simulator).

Design notes and roadmap live in doc/analysis.md.

Styles

The gallery lists presets in enum order (LoadingStyle.values): each card shows a live AnkaSuperLoading thumbnail, the same human-readable title used in the example, and a short subtitle. Tap a row to open the detail playground (two styles are shown under Style playground below).

LoadingStyle Description
pulseOrbit Three dots with a sequential pulse / scale wave.
ringStroke Indeterminate circular stroke with a sweeping arc.
shimmerBar Rounded bar with a travelling highlight (shimmer).
segmentSpinner Short arc segments rotating with staggered phase.
waveDots A row of dots oscillating vertically in a wave pattern.

Loading style gallery: cards for Pulse orbit, Ring stroke, Shimmer bar, Segment spinner, and Wave dots, each with a live loader preview and subtitle; app bar shows theme toggle.

The example home screen lists all five styles. Use the brightness icon to cycle system → light → dark theme and check contrast.

Style playground (detail)

Tapping any gallery row opens the same playground for that preset: bordered live preview, size (32–160 px) and loop duration (600–3200 ms) sliders, accent colour chips, and a copy-ready AnkaSuperLoading snippet aligned with the AnkaSuperLoading constructor.

Wave dots — preview, controls, and snippet for LoadingStyle.waveDots:

Wave dots detail: bordered loader preview, size and loop duration sliders, accent colour row, and sample code for AnkaSuperLoading with LoadingStyle.waveDots.

Pulse orbit — the same surface for LoadingStyle.pulseOrbit (only the style name, artwork, and generated snippet change):

Pulse orbit detail: same playground layout with three-dot loader, sliders, accent colours, and sample code for LoadingStyle.pulseOrbit.

Install

dependencies:
  anka_super_loading_package: ^0.1.3

dart pub add anka_super_loading_package

Usage

import 'package:anka_super_loading_package/anka_super_loading_package.dart';

AnkaSuperLoading(
  style: LoadingStyle.ringStroke,
  size: 64,
  color: Theme.of(context).colorScheme.primary,
  duration: const Duration(milliseconds: 1400),
  semanticsLabel: 'Loading data',
);

When color is omitted, loaders use Theme.of(context).colorScheme.primary. When size is omitted, the default side length is 48 (kAnkaDefaultLoadingSize). When duration is omitted, the default is 1400 ms (each loader interprets that as one loop where applicable). The widget wraps content in Semantics with semanticsLabel ?? 'Loading'. If MediaQuery.disableAnimations is true, each style shows a static frame instead of animating.

Example

Run the bundled gallery from the repository root:

cd example
flutter run

Screenshots above come from assets/screenshots/ in this repo; those paths resolve on pub.dev because the images ship with the published package.

Contributing

Issues and pull requests are welcome on GitHub.

Libraries

anka_super_loading_package
Custom indeterminate loading animations for Flutter.