animal_crossing_ui 0.5.3

A beautiful Flutter UI component library inspired by Animal Crossing. Features 44+ custom widgets, 16+ predefined themes (character & seasonal palettes), dynamic theme builder, and true flat design. Z [...]

Changelog

All notable changes to this project will be documented in this file.

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

0.4.0 - 2025-11-23

Added

Comprehensive Documentation

• Complete API documentation for all 60+ components
• Detailed usage examples and common patterns for every widget
• Developer tips including performance, accessibility, and best practices
• Real-world code samples demonstrating composition and integration
• Platform-specific notes and considerations

New Core Components

• ACUIAlert: Confirmation dialogs with async result handling
• ACUIToast: Colored notifications with global controller (success/error/warning/info types)
• ACUISearchBar: Search input with controller, clear button, and submit handling
• ACUIMenu: Popup context menus with positioning and generic return types
• ACUISnackbar: Bottom notifications with actions and auto-dismiss
• ACUIDatePicker: Calendar date selection with range constraints
• ACUITimePicker: Time selection with 12/24 hour format support
• ACUINavigationDrawer: Alternative side navigation with header/footer support

Layout & Display Components

• ACUIListView + ACUIListViewBuilder: Scrollable lists with automatic spacing
• ACUIGridView + ACUIGridViewBuilder: Responsive grid layouts with builder pattern
• ACUITabBar + ACUITabView: Segmented control tabs with state preservation
• ACUIBanner: Notification banners with semantic colors (info/warning/success/error)
• ACUIEmptyState: No content placeholders with icon, message, and action button
• ACUILinearProgress: Horizontal progress bars (determinate/indeterminate)
• ACUIProgressIndicator: Circular progress spinners with CustomPaint
• ACUIIcon: Icon rendering without Material dependencies

Enhanced Components

• ACUILoadingSpinner: Six animation styles (spinner, dots, typing, fallingLetters, leaf, bells)
• ACUIBellCounter: Currency display with count-up animation
• ACUIStarRating: Interactive ratings with half-star support
• ACUIDialogBox: Character dialogs with typing animation and speed control

Animal Crossing Game Components Collection (15 specialized widgets)

• ACUIInventoryGrid: Pocket-style item management
• ACUICatalogCard: Item browsing with price and ownership status
• ACUIReactionWheel: Circular emoji picker
• ACUIWeatherWidget: Weather condition display
• ACUIFossilDisplay: Museum collection tracker
• ACUIFruitCounter: Harvest counting with CustomPaint fruit icons
• ACUIMessageBottle: Expandable collectible messages
• ACUISeasonalBanner: Event and season announcements
• ACUINookPhone: App launcher grid interface
• ACUIVillagerCard: Character profile cards with personality types
• ACUIAchievementBadge: Reward badges with tier levels
• ACUIProgressTracker: Collection progress with percentage display

Improved

Theme System

• All 16+ predefined themes now include comprehensive documentation
• Character themes: Isabelle, Tom Nook, K.K., Celeste, Timmy, Kicks, Blathers, Sable
• Seasonal themes: Spring, Summer, Autumn, Winter
• Special themes: Nook Miles, Nook Shopping, Classic, Pastel Dream
• Full light/dark mode support across all themes
• Custom theme builder with complete color specification

Developer Experience

• ACUIResponsive utility with mobile/tablet/desktop breakpoints
• ACUIValidators for email, password, phone, and URL validation
• ACUILayouts presets for forms, grids, and card lists
• ACUIPageTransition with 8 animation types
• ACUIShadows for optional depth effects
• ACUIAnimations helper utilities

Documentation

• Professional README with no emojis
• Complete component reference with categorization
• Installation and quick start guide
• Best practices and usage patterns
• Migration guides between versions
• Comprehensive example app showcasing all features

Fixed

• Improved text rendering across all components
• Enhanced animation performance in loading spinners
• Better state management in interactive components
• Consistent spacing and padding throughout library

0.3.0 - 2025-11-15

Added

• ACUIRadio and ACUIRadioListTile for single-choice selections
• ACUIDropdown for selection menus
• ACUISection for labeled content organization
• ACUIContainer as lightweight styled wrapper
• ACUIExpansionPanel for collapsible sections
• ACUIDivider and ACUIVerticalDivider for visual separation

Changed

• Updated ACUILoadingSpinner with multiple animation styles
• Enhanced dialog APIs with showACUI* helper functions

0.2.0 - 2025-11-01

Added

• ACUICheckbox with animation support
• ACUISwitch with slide transitions
• ACUISlider for continuous value selection
• ACUIChip for tags and filters
• ACUIBadge for notifications
• ACUIAvatar for profile pictures
• ACUIListTile for structured list items
• ACUITooltip for hover information

Improved

• Better theme color consistency
• Enhanced responsive breakpoints
• Optimized widget performance

0.1.0 - 2025-10-15

Initial Release

• Core components: ACUIApp, ACUIButton, ACUICard, ACUITextField
• Navigation: ACUIScaffold, ACUIAppBar, ACUIDrawer, ACUIBottomNavigationBar
• Dialogs: ACUIDialog with showACUIDialog helper
• Theme system with 16+ predefined themes
• Light/dark mode support
• Responsive utilities
• Flutter 3.0+ compatibility
• Zero Material/Cupertino dependencies

• Theme-aware colors

Inventory & Items 🎒

• ACUIInventoryGrid: Pocket/storage grid system
  • 40+ customizable slots
  • Quantity badges on items
  • Selection highlighting
  • Tap and long-press support
• ACUICatalogCard 📖: Browse catalog items
  • Item image display
  • Price in bells
  • "Owned" status badge
  • Category labels
• ACUIFossilDisplay 🦴: Museum fossil tracker
  • Donation status indicator
  • Custom icon support
  • Compact grid-friendly design

Social & Reactions 😊

• ACUIReactionWheel: Circular reaction picker
  • 8 reaction slots
  • Smooth hover animations
  • Center label display
  • Customizable reactions
• ACUIVillagerCard 🏘️: Neighbor profiles
  • Personality types with colors
  • Species display
  • Catchphrase bubbles
  • Favorite star marking

Environment & Nature 🌸

• ACUIWeatherWidget ☀️: Island weather display
  • 5 weather conditions (sunny, cloudy, rainy, snowy, clear)
  • Temperature display
  • Location label
  • Gradient backgrounds
• ACUIFruitCounter 🍎: Harvest tracker
  • 5 fruit types (apple, orange, pear, peach, cherry)
  • Custom painted fruit icons
  • Increment/decrement buttons
  • Color-coded by fruit
• ACUISeasonalBanner 🌸: Seasonal events
  • 4 seasons with gradients
  • Seasonal emojis
  • Custom messages
  • Full-width design

Communication & Items 📱

• ACUIMessageBottle 📜: Wash ashore messages
  • Tap-to-open animation
  • Message reveal with scroll
  • Author attribution
  • Scale animation on press
• ACUINookPhone 📱: Island phone interface
  • App grid layout
  • Badge notifications
  • Custom app icons
  • Status bar simulation

Achievements 🏆

• ACUIAchievementBadge: Nook Miles achievements
  • 4 tiers (bronze, silver, gold, platinum)
  • Progress tracking
  • Reward display
  • Unlock animations

Documentation & Examples

• Complete Interactive Demo: All 15 components showcased in "AC Game 🎮" page
• Updated AC_COMPONENTS_GUIDE.md: Full usage guide for all components
• Zero Compile Errors: All components production-ready
• Theme Integration: Every component respects theme colors

0.4.0 - 2024-11-23

Added - MAJOR: 9 New Essential Components 🎯

• ACUIRadio & ACUIRadioListTile: Radio button for single selection with list tile variant
  • Generic type support for type-safe values
  • Circular flat design, no borders
  • Perfect for forms and settings
• ACUIDropdown & ACUIDropdownItem: Dropdown selector with overlay menu
  • Generic type support for flexible data
  • Smooth open/close animations
  • Positioned overlay menu system
• ACUISearchBar: Search input with clear button
  • Auto-show/hide clear button when text present
  • Full rounded pill shape
  • Text change and submit callbacks
• ACUILoadingSpinner: Circular loading spinner
  • Smooth rotation animation
  • Customizable size and color
  • Flat rounded stroke design
• ACUIEmptyState: Empty state with optional illustration
  • Optional title, icon, and action button
  • Center-aligned friendly design
  • Perfect for empty lists or no-data states
• ACUIBanner: Informational banner with context types
  • Four types: info, warning, success, error
  • Optional leading icon and dismiss button
  • Flat background with appropriate colors
• ACUIContainer: Flexible container widget
  • Customizable padding, margin, size
  • Optional color and border radius
  • Clean wrapper for content
• ACUISection: Section with title and content
  • Optional description and action widget
  • Perfect for organizing UI into labeled sections
  • Clean spacing and typography
• ACUIExpansionPanel: Expandable/collapsible panel
  • Smooth expand/collapse animation
  • Optional subtitle
  • Rotation animation for expand icon

Added - Powerful Utilities & Helpers 🛠️

• ACUIResponsive: Responsive design helper
  • Screen size breakpoints (mobile, tablet, desktop)
  • Device type detection
  • Responsive value picker
  • Responsive padding and sizing
• ACUIValidators: Form validation utilities
  • Email, phone, URL validators
  • Password strength checker (0-4 scale)
  • Length, number, and required field validators
  • Built-in error messages with friendly tone
• ACUILayouts: Common layout presets
  • Form layout with consistent spacing
  • Card grid for catalogs and inventories
  • Sectioned list for settings-style pages
  • Centered content layout
  • Scrollable content with spacing
  • Hero header for profile pages
• ACUIShadows: Subtle shadow presets
  • Four sizes: sm, md, lg, xl
  • Custom shadow builder
  • Very subtle for flat design aesthetic

Added - Documentation 📚

• GETTING_STARTED.md: Complete beginner-friendly guide
  • Installation instructions
  • First app tutorial
  • Component examples with code
  • Common patterns and use cases
  • Friendly, fun writing style
• README_NEW.md: Updated main documentation
  • Quick start guide
  • Component catalog
  • Theme showcase
  • Utility examples
  • Migration guide

Enhanced

• All new components follow strict Animal Crossing flat design
• No borders anywhere - pure flat aesthetic
• Comprehensive inline documentation with emoji and fun explanations
• All utilities have practical examples and use cases
• Rounded corners (BorderRadius 12px standard)
• Soft colors with opacity for states
• Zero Material/Cupertino dependencies maintained

Documentation

• Updated README.md with complete component list (44+ widgets)
• Updated library exports for all new components
• Component count increased from 35+ to 44+

0.3.0 - 2024-11-23

Added - MAJOR: Comprehensive Theme System 🎨

• ACUIThemePresets class with 16+ predefined themes
• Character Themes: Isabelle, Tom Nook, K.K. Slider, Celeste, Blathers, Timmy & Tommy
  • Each with unique color palettes matching character personalities
  • Full light/dark mode support for every character
• Seasonal Themes: Spring, Summer, Autumn, Winter
  • Cherry blossoms, tropical vibes, warm leaves, and snowy aesthetics
  • Perfect for seasonal app updates
• Utility Themes: Pastel, Vibrant, High Contrast
  • Practical palettes for accessibility and design preferences
• Dynamic Theme Builder: ACUIThemePresets.custom() for full customization
• Monochromatic Generator: ACUIThemePresets.monochromatic() creates full themes from single colors
• Theme Utilities: Helper methods for theme switching
  • getTheme(name) - Get theme by string name
  • getThemeDisplayName(name) - Get display name with emoji
  • Character/seasonal/utility theme lists for UI pickers

Enhanced

• Example app now includes comprehensive theme gallery
• New Themes page showcasing all available palettes
• Live theme switching demonstration
• Theme preview cards with color swatches
• Documentation for custom theme creation

Developer Experience

• Static presets for quick implementation
• Dynamic builders for advanced customization
• HSL color manipulation for harmonious palettes
• Every theme supports both light and dark modes
• Simple string-based theme switching API

0.2.0 - 2024-11-23

Changed - MAJOR UPDATE: True Flat Design! 🎨

• Removed ALL borders from all components to match Animal Crossing's authentic flat design
• Components affected:
  • ACUICard - pure flat card without borders
  • ACUIButton - all variants now borderless (primary, secondary, text)
  • ACUITextField - clean flat input field
  • ACUICheckbox - flat checkbox design
  • ACUISwitch - borderless toggle
  • ACUISlider - clean thumb without border
  • ACUIAppBar - flat top bar
  • ACUIBottomNavigationBar - clean bottom navigation
  • ACUINavigationDrawer - flat side drawer and items
  • ACUIDialog - borderless dialog
  • ACUIAlert - flat alert dialogs
  • ACUISnackbar - clean notifications
  • ACUIMenu - borderless menu items
  • ACUIChip - flat chip design
  • ACUIAvatar - clean circular avatar
  • ACUIBadge - flat notification badge
  • ACUITabBar - borderless tabs
  • ACUIDatePicker - flat date selector
  • ACUITimePicker - flat time selector
  • ACUITooltip - clean tooltips
• Result: Much cleaner, more authentic Animal Crossing aesthetic
• UI now relies purely on color, spacing, and rounded corners for visual hierarchy

Design Philosophy

Animal Crossing UI now truly embraces the flat, friendly design of the game series. No borders, no lines - just beautiful colors, soft shapes, and delightful interactions. This is the way Animal Crossing was meant to be! 🌳

0.1.1 - 2024-11-23

Added

• Custom SVG icon system with 8 Animal Crossing-style icons
• ACUISvgIcon widget for rendering custom SVG icons with theme integration
• SVG icons: arrows (left, right, up, down), check, close, calendar, clock
• Documentation for using third-party packages (Hugeicons, Google Fonts)

Changed

• Date picker now uses custom SVG icons instead of unicode arrows
• Time picker now uses custom SVG icons instead of unicode triangles
• Example app updated to use Hugeicons package for professional icons
• Example app now demonstrates coexistence with third-party packages
• Bottom navigation bar height increased from 60 to 68 pixels to prevent overflow
• README updated with section on third-party package integration

Dependencies

• Added flutter_svg: ^2.0.10 for SVG rendering
• Example app now includes google_fonts: ^6.1.0 and hugeicons: ^0.0.7

Fixed

• Bottom navigation bar overflow issue with icon + label layout
• Removed all emoji dependencies from example app

0.1.0 - 2024-11-23

Added

• Initial release of Animal Crossing UI
• Complete theme system with light/dark mode support
• 35+ custom widgets inspired by Animal Crossing design
• Core components:
  • ACUIApp - Root application widget
  • ACUITheme - Theme data provider
• Button components:
  • ACUIButton with variants (primary, secondary, text)
  • Multiple sizes (small, medium, large)
• Form components:
  • ACUITextField with focus states
  • ACUICheckbox with rounded design
  • ACUISwitch with smooth animations
  • ACUISlider with custom thumb
• Card and container components:
  • ACUICard with rounded corners
• Navigation components:
  • ACUIAppBar for top navigation
  • ACUINavigationDrawer for side navigation
  • ACUIBottomNavigationBar for bottom tabs
  • ACUITabBar and ACUITabView for tabs
• Dialog and overlay components:
  • ACUIDialog with custom animations
  • ACUIAlert for confirmation dialogs
  • ACUISnackbar for notifications
  • ACUITooltip for hover messages
  • ACUIMenu for popup menus
• Progress components:
  • ACUIProgressIndicator (circular)
  • ACUILinearProgress (horizontal)
• List and grid components:
  • ACUIListTile and ACUIListView
  • ACUIGridView and ACUIGridViewBuilder
• Picker components:
  • ACUIDatePicker for date selection
  • ACUITimePicker for time selection
• Display components:
  • ACUIBadge for notifications
  • ACUIAvatar for user images
  • ACUIChip for tags
  • ACUIDivider and ACUIVerticalDivider
• Animation utilities:
  • ACUIBounceAnimation
  • ACUIFadeAnimation
  • ACUISlideAnimation
• Theme system:
  • ACUIColors with Animal Crossing palette
  • ACUITextStyles for typography
  • ACUISpacing for consistent spacing
  • ACUIBorderRadius for rounded corners
• Comprehensive example app showcasing all components
• Unit tests for core components
• Complete documentation

Features

• Zero Material or Cupertino dependencies
• Custom design system from scratch
• Smooth animations and transitions
• Responsive and accessible
• Easy to customize and extend