smooth_avatar 1.0.3

A customizable fade-in circular avatar widget with animated loading, error handling and optional border.

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