super_button_package

Composable SuperButton API with SuperButtonStyle (variant, size, shape, tone) and a stack of SuperButtonEffect hooks. Out of the box: theme resolution via SuperButtonColorResolver (per tone / variant / state), and built-in effects (scale, focus ring, ink tint, elevation, loading overlay). The repository includes a full example gallery (filterable matrix on Gallery, effects playground, combinations, basic accessibility).

Status — pre-1.0: the public API and visuals will evolve. Follow SemVer and the CHANGELOG; lock to a specific version in apps.

Pub.dev version: the published version is the version field in pubspec.yaml at the release tag. Current line release: 0.3.1 (super_button_package: ^0.3.1).

Install

Add to your pubspec.yaml:

dependencies:
  super_button_package: ^0.3.1

Run:

flutter pub get

Usage

import 'package:super_button_package/super_button_package.dart';

SuperButton(
  onPressed: () {},
  label: const Text('Continue'),
  leading: const Icon(Icons.check),
  style: const SuperButtonStyle(
    variant: SuperButtonVariant.filled,
    size: SuperButtonSize.md,
    shape: SuperButtonShape.pill,
    tone: SuperButtonTone.primary,
  ),
  effects: const [SuperIdentityEffect()],
  loading: false,
  selected: false,
);

Note: gradient / glass / neumorphic variants are forward-compatible enums; see doc/PLACEHOLDER_VARIANTS.md until full paint paths ship.

Example app (showcase)

From the package repository:

cd example
flutter run
# Web: flutter run -d chrome

Screenshots

Combinations (example app, light theme): v1 button variants with columns as size (xs–xl) or tone (primary, neutral, success, …).

By size (xs–xl)	By tone

Documentation

API reference: pub.flutter-io.cn documentation tab (generated after publish).
Design and release process: doc/PHASE_1_SETUP.md, doc/PHASE_2_PACKAGE_AND_EXAMPLES.md, doc/PHASE_3_PUBLISHING.md.

Pub.dev follow-ups

Add more screenshots (e.g. Gallery, Effects) next to the files under assets/ and link them here; keep images reasonably small for the published tarball (see doc/PHASE_3_PUBLISHING.md §3.7 and .pubignore if needed).
Run dart pub global activate pana then pana in the package root for a quality report.

License

MIT