Features

• Animated sweep-gradient border
• One-shot boost via controller.triggerBoost()
• Press-and-hold boost via holdBoostMode
• Smooth phase continuity (no jump back after boost)
• Rounded corners, configurable border width, inner color, and shadows

Bottom Bar Demo

Installation

dependencies:
  animated_border_widgets: ^0.1.0

Quick Start

import 'package:animated_border_widgets/animated_border_widgets.dart';
import 'package:flutter/material.dart';

class Demo extends StatefulWidget {
  const Demo({super.key});

  @override
  State<Demo> createState() => _DemoState();
}

class _DemoState extends State<Demo> {
  final controller = AnimatedGradientBorderController();

  @override
  void dispose() {
    controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return AnimatedGradientBorder(
      controller: controller,
      borderRadius: BorderRadius.circular(20),
      borderWidth: 1.8,
      colors: const [
        Color(0xFFED7203),
        Color(0xFFFFA726),
        Color(0xFFFFD54F),
        Color(0xFFFFE0B2),
        Color(0xFFFFB74D),
        Color(0xFFFF8A65),
        Color(0xFFED7203),
      ],
      child: SizedBox(
        height: 56,
        child: ElevatedButton(
          onPressed: controller.triggerBoost,
          child: const Text('Boost'),
        ),
      ),
    );
  }
}

Hold Boost Mode

Use holdBoostMode for press-and-hold interactions:

AnimatedGradientBorder(
  holdBoostMode: isPressed,
  holdBoostTurnsPerSecond: 0.9,
  colors: palette,
  child: const SizedBox(height: 52),
)

API Overview

• AnimatedGradientBorder
  • colors
  • borderRadius
  • borderWidth
  • turnDuration
  • boostDuration
  • boostTurns
  • holdBoostMode
  • holdBoostTurnsPerSecond
  • innerColor
  • boxShadow
  • controller
• AnimatedGradientBorderController
  • triggerBoost()

This keeps images visible in pub.dev README while excluding local assets/ files from the published package archive.

Example

See the complete demo in example/:

• Demo bottom bar
• Tap boost button
• Hold boost button
• Gray border -> animated border reveal on hold

License

MIT License. See LICENSE.

How to Contribute

To get started, read CONTRIBUTING.md to learn about the guidelines within this project.

Changelog

Refer to the Changelog to get all release notes.

Maintainers

ADC STUDIO

Valerij Shishov

This library is open for issues and pull requests. If you have ideas for improvements or bugs, the repository is open to contributions!