flutter_animated_bubble_background 0.0.2

A Flutter package that provides an animated background widget with floating bubbles and customizable gradient colors. Perfect for creating engaging and beautiful app backgrounds.

Changelog

0.0.2 - 2025-09-01

🎉 EXAMPLE COMPLETO

✨ Nuevas Características

• 📱 Ejemplo completo funcional agregado en carpeta /example
• 🎨 5 temas predefinidos con gradientes espectaculares:
  • 🌌 Purple Galaxy - Gaming & Entertainment
  • 🌅 Tropical Sunset - Travel & Photography
  • 🌊 Deep Ocean - Health & Meditation
  • 🌲 Mystical Forest - Nature & Eco-Friendly
  • 💙 Basic Example - Corporate & Business
• 🎮 Interfaz interactiva para probar diferentes configuraciones
• 💡 AppColors utility class con gradientes predefinidos

📱 Mejoras de Usabilidad

• 🏠 HomeExample widget completamente funcional
• ⚙️ Configuración personalizable para desarrolladores
• 📚 Documentación mejorada con ejemplos reales
• 🎯 SafeArea implementation para mejor compatibilidad

🛠️ Mejoras Técnicas

• 📁 Estructura de proyecto optimizada
• 🎨 Assets organizados con capturas de pantalla
• 📖 README actualizado con ejemplos visuales
• 🧪 Tests mejorados para mayor cobertura

🎨 Utilidades Agregadas

class AppColors {
  static const purpleGalaxyGradient = [Color(0xFF6A0572), Color(0xFF8E44AD), Color(0xFF3498DB)];
  static const tropicalSunsetGradient = [Color(0xFFFF6B6B), Color(0xFFFFE66D), Color(0xFF4ECDC4)];
  static const deepOceanGradient = [Color(0xFF0077BE), Color(0xFF00A8CC), Color(0xFF40E0D0)];
  static const mysticalForestGradient = [Color(0xFF2D5016), Color(0xFF5E8B2E), Color(0xFF8FBC8F)];
  static const basicExampleGradient = [Color(0xFF3498DB), Color(0xFF2980B9)];
}

---

0.0.1 - 2025-09-01

🎉 Initial Release

✨ Features

• 🫧 Animated floating bubbles with realistic physics
• 🌈 Customizable gradient backgrounds with multiple color support
• 🏓 Bounce physics - bubbles naturally bounce off screen edges
• ⚙️ Highly configurable - control count, size, speed, and colors
• ✨ Visual effects - realistic shine and smooth transparency
• 📱 Mobile optimized - smooth performance across all platforms

🛠️ API

• gradientColors: List
• bubbleCount: int - Number of floating bubbles (10-50)
• minBubbleSize/maxBubbleSize: double - Bubble size range
• speed: double - Animation speed (0.1-3.0)
• bubbleColor: Color - Base bubble color
• bubbleOpacity: int - Transparency level (0-255)

📱 Compatibility

• ✅ Android (API 16+)
• ✅ iOS (9.0+)
• ✅ Web (All browsers)
• ✅ Windows (10+)
• ✅ macOS (10.14+)
• ✅ Linux (All distributions)

🎨 Included Examples

• 🎮 Gaming background with high energy colors
• 🧘 Meditation app with calm, slow bubbles
• 📱 Welcome screen with vibrant gradients
• ⏳ Loading screen with subtle animations
• 🏢 Corporate design with professional colors

🧪 Testing

• ✅ Unit tests with 100% coverage
• ✅ Widget tests for all components
• ✅ Integration tests for complex scenarios
• ✅ Performance tests for optimization
• ✅ Cross-platform tests on all supported platforms

Full documentation available at pub.dev