astra_ui 0.1.2

A beautiful modern Flutter UI component library with 37+ components. Includes buttons inputs chips avatars tabs and more. Inspired by shadcn/ui.

Changelog

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

0.1.2 - 2026-01-26

✨ New Features

• AstraSearchInput: Added right icon support with action callback

  • New rightIcon parameter for custom action icons (e.g., filter button)
  • New rightIconColor parameter for icon color customization
  • New onRightIconTap callback for icon tap actions
  • Both clear button and right icon can be shown simultaneously

• AstraAvatar: Added local file and asset image support

  • New imagePath parameter for local file paths
  • New assetPath parameter for asset images
  • Priority order: assetPath > imagePath > imageUrl > initials
  • Automatic fallback to initials on image load error

📚 Documentation

• Updated README with new AstraSearchInput parameters and examples
• Updated README with new AstraAvatar image loading options
• Added usage examples for multi-icon search inputs

0.1.1 - 2026-01-25

🔧 Fixes

• Resolved deprecation warnings for Color.withOpacity by using Color.withValues
• Updated SDK constraints to Flutter 3.27+ and Dart 3.6+
• Improved performance by adding const constructors
• Removed test app artifacts from distribution

0.1.0 - 2026-01-25

🎉 Initial Release

First public release of AstraUI with 37 components!

✨ Added Components

Buttons (5)

• AstraSolidButton - Solid filled button with mint green background
• AstraOutlineButton - Border only button
• AstraGhostButton - Transparent button with hover effect
• AstraDestructiveButton - Red/dusty rose button for dangerous actions
• AstraLinkButton - Link style button with URL launcher support

Inputs (4)

• AstraTextInput - Text input with label, error states, multiline support
• AstraEmailInput - Email input with validation and icon
• AstraPasswordInput - Password input with show/hide toggle
• AstraSearchInput - Search input with clear button

Controls (1)

• AstraToggle - Toggle switch for on/off states

Dropdowns (2)

• AstraSimpleDropdown - Basic dropdown with options
• AstraSearchDropdown - Searchable dropdown with filter

Tabs (3)

• AstraLineTabs - Tabs with underline indicator
• AstraPillTabs - Pill-shaped tabs
• AstraSegmentTabs - Segmented control style tabs

Chips (11)

• AstraChip - Basic chip with optional icon and delete
• AstraOutlineChip - Border only chip
• AstraSolidChip - Solid filled chip
• AstraChoiceChip - Selectable chip with toggle state
• AstraDottedChip - Chip with dotted/dashed border
• AstraGradientChip - Chip with gradient background
• AstraGlowChip - Chip with glow/shadow effect
• AstraPillChip - Extra rounded pill-shaped chip
• AstraIconOnlyChip - Circular chip with only icon
• AstraStripedChip - Chip with diagonal striped pattern
• AstraAnimatedChip - Chip with press animations

Avatars (6)

• AstraAvatar - Basic circular avatar with image/initials
• AstraRingAvatar - Avatar with colored ring border
• AstraGradientAvatar - Avatar with gradient background
• AstraStatusAvatar - Avatar with status indicator (online/offline/busy/away)
• AstraIconAvatar - Avatar with icon instead of initials
• AstraGroupAvatar - Stacked avatars with overflow count

Foundation (2)

• AstraColors - Beautiful color palette (mint green, dusty rose, soft peach)
• AstraIcon - Universal icon component used across all components

📱 Example App

• Complete showcase app with 7 tabs
• Device Preview integration for testing responsive design
• Interactive examples for all components
• Default device: Samsung Galaxy Note 20 Ultra

🎨 Features

• ✅ 37 ready-to-use components
• ✅ Beautiful, modern design
• ✅ Fully customizable
• ✅ Responsive design
• ✅ Cross-platform support (Android, iOS, Web, Windows, macOS, Linux)
• ✅ Network image support with error handling
• ✅ Icon support across all components
• ✅ Factory constructors for easy usage
• ✅ Clean, professional UI

📚 Documentation

• Comprehensive README with usage examples
• Component status tracking file
• Detailed API documentation for each component
• Quick start guide

🔧 Technical

• Minimum Flutter version: 3.24.0
• Minimum Dart SDK: 3.5.0
• Dependencies: url_launcher ^6.3.1

---

Future Releases

See COMPONENTS_STATUS.md for planned components.

Planned for 0.2.0

• Badges (5 components)
• Cards (4 components)
• Alerts (4 components)
• Progress indicators (3 components)

Planned for 0.3.0

• Modals & Dialogs (3 components)
• Tooltips & Popovers (2 components)
• Notifications (3 components)

---