Smooth Avatar

A customizable fade-in circular avatar widget for Flutter.

SmoothAvatar provides animated image loading, error handling and optional border styling, making it a flexible and production-ready alternative to CircleAvatar.

📸 Preview

✨ Features

  • Animated fade-in when image loads
  • Supports NetworkImage, AssetImage, FileImage, and any ImageProvider
  • Optional border color and width
  • Built-in error fallback widget
  • Lightweight and easy to integrate

📦 Installation

Add this to your pubspec.yaml:

dependencies:
  smooth_avatar: ^1.0.3

Then run:

flutter pub get

🚀 Usage

import 'package:smooth_avatar/smooth_avatar.dart';

SmoothAvatar(
  image: NetworkImage(
    'https://randomuser.me/api/portraits/women/68.jpg',
  ),
  radius: 50,
  borderColor: Colors.blue,
  borderWidth: 3,
)

🛠 Example

A complete runnable example is available in the example/ folder of this repository, demonstrating loading states, error handling, and asset usage.

📄 License

This package is released under the MIT License.

Created with ❤️ by Gregorio Cruz

Libraries

smooth_avatar