atomic_flutter_kit 0.12.2

A comprehensive atomic design system for Flutter applications with Material Design 3 support.

Changelog

All notable changes to the Atomic Flutter design system will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.12.2 - 2025-01-30 - 📚 Documentation Enhancement

Added

• 📚 Comprehensive library-level documentation
  • Added detailed documentation to main library file (atomic_flutter_kit.dart)
  • Added documentation to utility libraries (atomic_date_time_utils.dart)
  • Enhanced API documentation for key components (AtomicButton, AtomicColors)
• 📖 Development guidelines documentation
  • Created comprehensive CLAUDE.md with development standards
  • Added AI assistant guidelines and troubleshooting tips
  • Documented component patterns and best practices

Changed

• 📝 Improved README.md
  • Updated package title to "Atomic Flutter Kit"
  • Fixed package version reference (0.0.1 → 0.12.2)
  • Enhanced documentation quality for better pub.dev scoring

Fixed

• 🔧 Resolved pub.dev validation issues
  • Fixed dartdoc warnings for library-level documentation
  • Achieved 160/160 pub points (up from 130/160)
  • Eliminated all package validation warnings

0.12.1 - 2025-01-30 - 🔧 Package Name Update

Changed

• 📦 Package renamed from atomic_flutter to atomic_flutter_kit
  • Updated package name in pubspec.yaml
  • Renamed main library file from atomic_flutter.dart to atomic_flutter_kit.dart
  • Updated library declaration to atomic_flutter_kit
  • Updated all GitHub repository URLs
  • Updated test imports to use new package name

Fixed

• 🔧 Fixed package naming conflicts for pub.dev publishing
• 🔧 Updated import references in test files

0.12.0 - 2024-12-21 - 🧹 Legacy Code Cleanup Complete

Breaking Changes - Legacy Code Removal

• ❌ Removed all @Deprecated typedefs from models
  • ActionListItem → Use AtomicActionListItem
  • BottomBarItem → Use AtomicBottomBarItem
  • IconListItem → Use AtomicIconListItemModel
  • SelectListItem → Use AtomicSelectListItem
  • TextListItem → Use AtomicTextListItem
  • SheetSelectListController → Use AtomicSheetSelectController
  • ValueController → Use AtomicValueController
• ❌ Removed legacy color and dimension classes
  • ColorResource → Use AtomicColors
  • DimensionResource → Use AtomicSpacing
  • Deleted /config/legacy_colors.dart
  • Deleted /config/legacy_dimensions.dart
  • Deleted /config/config.dart
• ❌ Removed deprecated enums and extensions
  • LoadingEnum → Use AtomicLoadingState
  • GenderEnum → Use AtomicGender
  • StatusEnum → Use AtomicStatus
  • Removed legacy enum conversion extensions
• ❌ Removed deprecated icon class
  • IconFonts → Use AtomicCustomIcons
• ❌ Removed legacy map extension method
  • containsCheck → Use getWithTransform

Changed

• 🔧 Cleaned up exports in atomic_flutter.dart (removed legacy config export)
• 🔧 Enhanced MapExtension with improved utility methods
• 🔧 Improved code quality and documentation

Package Status

• ✅ 100% Modern: Zero legacy/deprecated code
• ✅ Clean Architecture: Atomic design system fully implemented
• ✅ Production Ready: Battle-tested components
• ✅ Zero External Dependencies: For core features (no Dio, no Firebase)

Notes

• The original /atomic project folder has been deleted
• Migration from /atomic to /atomic_flutter is complete
• All components now follow modern Flutter standards

0.11.0 - 2024-12-21

Added - Final Migration Components

• Added AtomicOtpStatus enum for OTP operations
• Added AtomicCustomIcons class for custom icon font support
• Added AtomicBaseService abstract class for pagination and state management
• Added AtomicSecureStorageExample as reference implementation for secure storage
• Added storage barrel export at services/storage/storage.dart

Changed

• Reorganized storage exports to prevent naming conflicts
• Enhanced documentation with more examples

Migration Statistics

• Total files migrated: 42/58 (72%)
• Package-suitable files: 90% complete
• App-specific files excluded: 9

0.10.0 - 2024-12-21 - 🌐 Phase 5 Enhanced Network & Services Complete

Added - Phase 5 Complete Infrastructure Migration

Network Infrastructure (NEW)

• ✨ AtomicNetworkClient - Clean HTTP client without Dio dependency

  • Built on Flutter's http package for zero external dependencies
  • Generic response types with proper JSON parsing
  • Interceptor system for request/response modification
  • Configurable timeouts and headers
  • Base URL support for API consistency
  • Comprehensive error handling with AtomicNetworkException

• ✨ Interceptors System

  • AtomicNetworkInterceptor - Base interface for interceptors
  • AtomicLoggingInterceptor - Request/Response logging with customizable options
    • Log requests, responses, headers, and body
    • Beautiful console formatting for debugging
  • AtomicAuthInterceptor - Authentication header management
    • Dynamic token provider support
    • Configurable header names and prefixes
    • Automatic 401 handling with token refresh

Storage Infrastructure (NEW)

• ✨ AtomicStorageInterface - App-agnostic storage interface
  • Abstract interface for any storage implementation
  • Basic operations: read, write, delete, clear, contains, getKeys
  • Extension methods for typed operations with encoder/decoder
  • AtomicMemoryStorage - In-memory implementation for testing
  • Ready for SharedPreferences, Hive, SQLite implementations

Services (Enhanced)

• ✅ AtomicHapticService - Already migrated with Flutter's HapticFeedback API

Migration Summary

• Total Files: 58
• Migrated: 39 ✅
• Excluded (App-specific): 9 ❌
• Remaining: 10 🚧
• Completion: 84% (of package-suitable files)

Technical Improvements

• Zero external dependencies for network layer (replaced Dio with http)
• Clean architecture with interface-based design
• Type-safe generic implementations
• Comprehensive error handling
• Ready for production use with interceptors

0.9.0 - 2024-12-21 - 🌐 Phase 5 Selective Migration Complete

Added - Phase 5 Services Migration

• ✨ Services:
  • AtomicHapticService - Modern haptic feedback service using Flutter's built-in HapticFeedback API
    • All standard haptic types: light, medium, heavy impact
    • Selection click and vibrate support
    • Semantic feedback types: success, warning, error
    • AtomicHapticType enum with extension for convenient usage
    • Type-safe API with async support
    • No external dependencies, using platform native APIs

Migration Decisions

• ❌ Excluded from package (app-specific):
  • Network infrastructure (Dio dependent)
  • Notification service (Firebase dependent)
  • Storage services (app-specific implementation)
  • These remain in the original atomic project

Migration Progress

• Total Files: 58
• Migrated: 36 ✅
• Excluded: 9 ❌ (app-specific)
• Remaining: 13 🚧
• Completion: 78% of package-suitable files

0.8.0 - 2024-12-21 - 🎯 Phase 4 Migration Complete

Added - Phase 4 Controllers & Enums Migration

• ✨ Controllers (Providers):
  • AtomicSheetSelectController<T> - Enhanced sheet selection controller with generics
    • Multi-selection support with allowMultipleSelection flag
    • Validation and filtering capabilities
    • Type-safe value extraction with selectedValue and selectedValues
  • AtomicValueController<T> - Enhanced value notifier with custom listeners
    • Custom VoidCallback listeners with indexed removal
    • Value-change listeners with ValueChanged<T?> support
    • Conditional notification with shouldNotify predicates
  • AtomicListValueController<T> - Specialized controller for list values
    • List operations: add, remove, toggle, clear
    • Helper methods: contains, isEmpty, isNotEmpty, length
• ✨ Enums:
  • AtomicLoadingState - Loading states with transition validation and helpers
    • States: idle, loading, success, error, refreshing
    • Validation: canTransitionTo with state flow checking
    • UI Helpers: color, icon, description getters
  • AtomicStatus - Comprehensive status enum with semantic meanings
    • States: loading, success, error, empty, cannot, timeout, idle, cancelled, warning
    • UI Integration: color, icon, displayText properties
    • State categorization: isCompleted, isActive, isNegative helpers
  • AtomicGender - Inclusive gender options with modern approach
    • Options: male, female, nonBinary, preferNotToSay, other
    • Accessibility: displayText, shortText, commonPronouns
    • API Integration: apiValue, fromApiValue, fromString
    • Form helpers: formOptions, basicOptions, inclusiveOptions

Technical Improvements

• 📚 Updated barrel exports in atomic_flutter.dart to include providers and enums
• 🔧 Migrated 5 files from atomic project to atomic_flutter package
• ✅ Enhanced controllers with generic type support and advanced features
• ✅ Modern enum implementation with enhanced utility methods
• ✅ Legacy compatibility support for smooth migration
• 🎯 Achieved 60% migration progress (35/58 files)

Migration Progress Update

• ✅ Phase 1: Atomic Components - COMPLETE
• ✅ Phase 2: Extensions & Utilities - COMPLETE
• ✅ Phase 3: Data Models - COMPLETE
• ✅ Phase 4: Controllers & Enums - COMPLETE
• 🚧 Phase 5: Network & Services - REMAINING

0.7.0 - 2024-12-21 - 🚀 Phase 1-3 Migration Complete

Added - Phase 1 Components Migration

• ✨ Container Components:
  • AtomicAnimatedContainer - Animated version of smooth container with implicit animations
  • AtomicIconBox - Container with icon, customizable styling and tap interactions
• ✨ Input Components:
  • AtomicButtonCheck - Button-style checkbox with text label and smooth animations
• ✨ Feedback Components:
  • AtomicDotLoading - Animated loading indicator with bouncing dots (small, medium, large sizes)
• ✨ Sheet Components:
  • AtomicCustomSheetBody - Body content for bottom sheets with customizable styling
  • AtomicSheetBuilder - Helper for building bottom sheets with consistent styling
• ✨ Layout Components:
  • AtomicStackedBody - Layout component for creating stacked card effects
• ✨ Utilities:
  • SvgProvider - ImageProvider for SVG files supporting network, asset, and file sources

Added - Phase 2 Extensions Migration

• ✨ Extension Utilities:
  • BoolExtension - Boolean utilities with API serialization support
  • CloneExtension - Deep cloning using isolates with sync/async methods
  • MapExtension - Enhanced map operations with type safety
  • ListExtension - Advanced list operations including pluck functionality

Added - Phase 3 Models Migration

• ✨ Data Models:
  • AtomicActionListItem - Action list item model with callbacks and unique identifiers
  • AtomicBottomBarItem - Bottom navigation bar item model with badge support
  • AtomicIconListItemModel - Icon list item model with customizable colors (renamed to avoid conflicts)
  • AtomicSelectListItem<T> - Generic selectable list item model with type safety
  • AtomicTextListItem - Simple text list item model with styling options

Config

• 🔧 LegacyColors - Simplified backward compatibility layer (reduced complexity)
• 🔧 LegacyDimensions - Legacy dimension mappings for smooth migration

Fixed

• 🔧 Fixed ui.PictureRecorder import issues in SvgProvider
• 🔧 Fixed BoxShadow type issues in AtomicStackedBody
• 🔧 Fixed import paths for atomic_smooth_container references
• 🔧 Resolved naming conflicts between models and UI components

Technical Improvements

• 📚 Updated barrel exports in atomic_flutter.dart to include all new components and models
• 🔧 Migrated 13 components + 5 models from atomic project to atomic_flutter package
• ✅ Maintained Material Design 3 compliance across all migrated components
• ✅ Integrated all components with atomic theme system
• 🎯 Achieved 52% migration progress (30/58 files)

0.6.0 - 2024-12-21 - 🎉 ALL CRITICAL MOLECULES COMPLETED!

Added - Final Critical Molecule

• ✨ AtomicTimePicker - Material Design time picker with theme integration
• ✨ AtomicSimpleTimePicker - Simple time picker for basic use cases
• ✨ Time formatting support - 12/24 hour format with automatic detection
• ✨ Variant support - Filled, outlined, and underlined variants

🎯 MILESTONE ACHIEVED: Production-Ready Design System

• ✅ 35+ Atomic Components - Complete atoms library
• ✅ 7 Major Molecules - All critical combinations completed
• ✅ 100% Material Design 3 - Fully compliant implementation
• ✅ Complete Theme System - Colors, typography, spacing, borders, shadows
• ✅ Responsive Utilities - Mobile-first responsive helpers
• ✅ Accessibility Ready - WCAG 2.1 AA compliance
• ✅ Production Tested - All components lint-clean and test-ready

Architecture Completeness

• 🏗️ Atoms Phase - COMPLETE ✅
• 🧩 Molecules Phase - COMPLETE ✅
• 🔬 Organisms Phase - PLANNING 🚧
• 📱 Templates Phase - FUTURE 📋
• 🏛️ Pages Phase - FUTURE 📋

Next Phase: Organisms (Complex Components)

• 📊 AtomicDataTable - Data tables with sorting/filtering
• 📝 AtomicForm - Complete form components
• 🏗️ AtomicLayout - Responsive layout templates
• 📈 AtomicStepper - Multi-step workflow components

0.5.0 - 2024-12-21

Added - Major Molecules Components

• ✨ AtomicListItem - Material Design list item with flexible layout options
• ✨ AtomicUserListItem - Specialized list item for user display with avatar support
• ✨ AtomicIconListItem - List item with icon container for menu items
• ✨ AtomicAppBar - Material Design app bar with theme integration and modern features
• ✨ AtomicSimpleAppBar - Simplified app bar for common use cases
• ✨ AtomicSearchAppBar - App bar with integrated search functionality
• ✨ AtomicDatePicker - Material Design date picker with theme integration
• ✨ AtomicSimpleDatePicker - Simple date picker for basic use cases
• ✨ AtomicDateRangePicker - Date range picker for selecting date ranges

Enhanced

• 🔧 Export structure - Organized molecules exports by category
• 📚 Documentation - Updated README with comprehensive component list
• 🏗️ Architecture - Improved folder structure for molecules

Developer Experience

• 🚀 Helper Components - Added specialized variants for common use cases
• 🎨 Theming - All new components fully integrated with atomic theme system
• ♿ Accessibility - WCAG 2.1 AA compliance maintained across all components

0.4.0 - 2024-12-21

Added - Molecules Level Components

• ✨ AtomicDropdown - Material Design dropdown with enhanced functionality and filtering
• ✨ AtomicFormField - Wrapper for form inputs with validation support
• ✨ AtomicNavigationBar - Material Design 3 bottom navigation bar
• ✨ AtomicNavigationRail - Navigation rail variant for larger screens
• ✨ AtomicNavigationDestination - Data class for navigation destinations with badge support

Architecture Updates

• 🏗️ Molecules folder structure - Added organized molecules directory structure
• 🏗️ Export system - Updated barrel exports to include new molecules
• 🏗️ Documentation - Updated README with new component categories

Framework Compliance

• ✅ Material Design 3 - All navigation components follow MD3 standards
• ✅ Atomic Design - Proper separation of atoms vs molecules
• ✅ Flutter Standards - Following umituz.com Flutter mobile standards

0.3.0 - 2024-12-21

Added

• ✨ AtomicSlider - Material Design slider with theme integration
• ✨ AtomicRangeSlider - Range slider for selecting value ranges
• ✨ AtomicProgress - Linear and circular progress indicators
• ✨ AtomicProgressCard - Progress indicator with card wrapper
• ✨ AtomicStepProgress - Multi-step progress indicator for workflows
• ✨ AtomicTooltip - Material Design tooltip with theme integration
• ✨ AtomicRichTooltip - Enhanced tooltip with rich content support
• ✨ AtomicTooltipHelper - Utility functions for tooltip positioning

Enhanced

• 🔧 Build Configuration - Updated flutter_svg dependency
• 🔧 Type Safety - Improved enum definitions and type checking
• 🔧 Performance - Optimized animation configurations

Improved

• 🔧 Better Material Design 3 compliance
• 🎯 Consistent theme integration across all components
• 📊 Enhanced accessibility support
• ⚡ Performance optimizations for 60fps animations

Documentation

• 📚 Updated README with new component documentation
• 📝 Added comprehensive usage examples
• 🎯 Component roadmap updated

0.2.0 - 2024-12-20

Added

• ✨ AtomicText - Flexible text component with theme integration
• ✨ AtomicImage - Multi-source image component with loading states
• ✨ AtomicSvg - SVG image component with theme integration
• ✨ AtomicSmoothContainer - Container with smooth corners
• ✨ AtomicAnimatedSmoothContainer - Animated smooth container
• ✨ AtomicAlert - Notification/alert component with multiple variants
• ✨ AtomicTag - Small label/tag component for categorization

Dependencies

• 📦 Added flutter_svg: ^2.0.9 for SVG support
• 📦 Added intl: ^0.20.2 for internationalization support

0.1.0 - 2024-12-19

Added

• 🎉 Initial release of Atomic Flutter Design System
• 🎨 Core Theme System with atomic design tokens
• 🔘 Buttons: AtomicButton, AtomicIconButton
• 📦 Containers: AtomicCard, AtomicGradientContainer, AtomicCollapseBox
• 📝 Inputs: AtomicTextField, AtomicSwitch, AtomicCheckbox, AtomicRadio
• 🎯 Icons: AtomicIcon with standardized sizing
• 🔄 Feedback: AtomicLoader, AtomicChip, AtomicShimmer, AtomicBadge, AtomicToast
• 👤 Display: AtomicAvatar
• 📋 Overlays: AtomicDivider, AtomicDialog, AtomicBottomSheet
• 🎨 Design Tokens: Colors, Typography, Spacing, Animations, Shadows, Borders
• 📱 Utilities: AtomicResponsive, AtomicDebouncer

Core Features

• 🌙 Dark/Light theme support
• 📱 Responsive design utilities
• ♿ Accessibility compliance (WCAG 2.1 AA)
• ⚡ 60fps performance optimization
• 🎯 Material Design 3 compliance
• 🔧 TypeScript-style null safety

Documentation

• 📚 Comprehensive README with usage examples
• 🎯 Component roadmap and feature matrix
• 📝 Installation and setup guide