auraa_ui 2.1.0

UI Component Library Inspired by material-tailwind and shadcnui, NextUI , Chakra UI

2.1.0 — 2026-05-13

✨ New Components (18)

Component	Class	Description
Text Field	AuiTextField	Outlined / filled / underlined input with label, hint, error, icons, char count, obscure toggle
Card	AuiCard	Elevated card with header, footer, image slot, tap; .outlined, .flat variants
Badge	AuiBadge	Count / dot overlay on any widget; 4 corner positions, 99+ clamp, .dot constructor
Chip	AuiChip	Selectable / dismissable tag with avatar; .outlined, .soft variants
Progress	AuiProgress	Linear + circular, determinate + indeterminate, animated, labeled; .linear, .circular constructors
Avatar	AuiAvatar	Network image with initials fallback, badge slot, circle/square shape; .small, .large, .xl constructors
Skeleton	AuiSkeleton	Left-to-right shimmer placeholder; .text, .circle, .rect presets
Alert	AuiAlert	Persistent banner: info / success / warning / danger; dismiss button, action slot
Bottom Sheet	AuiBottomSheet	Modal sheet with drag handle, title bar, snap height; AuiBottomSheet.show()
Switch	AuiSwitch	Custom animated toggle; label, disabled, size scale, SwitchLabelPosition
Tooltip	AuiTooltip	Hover/long-press tooltip wrapping any child; TooltipPosition
Dropdown	AuiDropdown	Styled select matching AuiTextField; AuiDropdownItem model, .filled variant
Checkbox	AuiCheckbox	Tristate checkbox with label; CheckboxLabelPosition
Radio Group	AuiRadioGroup	Radio button group; AuiRadioOption model, RadioGroupDirection
Bottom Nav	AuiBottomNav	Custom bottom navigation bar; badge support, indicator pill, AuiBottomNavItem model
Tab Bar	AuiTabBar	Scrollable tabs; underline/pill indicator; AuiTab model, TabIndicatorStyle
Stepper	AuiStepper	Horizontal/vertical step indicator; AuiStep model, AuiStepState, StepperDirection
Accordion	AuiAccordion	Animated expand/collapse panels; single or multi-open; AuiAccordionItem model

📐 Project conventions

• CONTRIBUTING.md added — folder layout, naming, theme-first rules, zero-deps rule, test + example requirements, PR checklist.

---

2.0.0 — 2026-05-12

This is a major release with breaking API changes. Please read the migration guide below before upgrading.

---

⚠️ Breaking Changes

Carousel

• AuraUICarousel now takes List<CarouselItem> instead of List<String> images. Migration:

  // Before
  AuraUICarousel(images: ['https://...'], pageController: ...)
  
  // After
  AuraUICarousel(items: [CarouselItem(imageUrl: 'https://...')], pageController: ...)
  

• AuraUICarouselTappable is removed. Use AuraUICarousel with CarouselItem(onTap: ...) instead.
• CarouselItem.onTap is now nullable. Previously it was required; you can now omit it for non-interactive slides.

Dialog

• AuiDialog.static(...) is renamed to AuiDialog.show(...). Migration:

  // Before
  AuiDialog.static(context: context, title: 'Hello')
  
  // After
  AuiDialog.show(context: context, title: 'Hello')
  

  The old .static(...) is removed. Update call sites to .show(...).

Toasts

• Toast functions are replaced by the AuiToast class with static methods.

  Old	New
  simpleToastMessage(...)	AuiToast.simple(...)
  lightBackgroundToastMessage(...)	AuiToast.light(...)
  iconMessage(...)	AuiToast.withIcon(...)

  Old function names are removed. Update call sites to use AuiToast.

• Parameter textColour renamed to textColor in all toast methods for consistency.

• width and duration are now configurable (defaults: 300px, 1200ms — unchanged behaviour).

---

✨ New Features

• AuraUITheme ThemeExtension — configure AuraUI defaults through Flutter's standard theming system:

  MaterialApp(
    theme: ThemeData(
      extensions: [AuraUITheme(buttonRadius: 12)],
    ),
  )
  

• AuiButton.borderRadius now works. The BorderRadiusGeometry parameter was declared but never applied; it is now fully respected and takes priority over borderRadiusAll.
• AuiButton shape resolution priority: borderRadius → borderRadiusAll → AuraUITheme → MyConstant fallback.
• AuiButton text-type now also respects shape/msShape.
• Carousel auto-play timer is now properly cancelled on widget dispose (fixes memory leak).
• Network-image placeholder uses a valid 1×1 transparent PNG instead of an empty asset path.

---

🗑️ Removed

• AuiSimpleButton — use AuiButton instead.
• AuiLoadingButton — use AuiButton with a CircularProgressIndicator child instead.
• AuiIconButton — use AuiButton with an Icon + Text row child instead.
• AuiDialog.static(...) — use AuiDialog.show(...) instead.
• simpleToastMessage(...) — use AuiToast.simple(...) instead.
• lightBackgroundToastMessage(...) — use AuiToast.light(...) instead.
• iconMessage(...) — use AuiToast.withIcon(...) instead.
• AuraUICarouselTappable — use AuraUICarousel with CarouselItem(onTap: ...) instead.

---

🔧 Internal / Non-breaking

• Dart SDK bumped to >=3.5.0, Flutter to >=3.24.0.
• flutter_lints bumped to ^4.0.0.
• _transparentPixel moved to shared carousel_utils.dart.
• Basic widget tests added for AuiButton, AuraUICarousel, AuiDialog, SparklesText, AuraUITheme.
• Static analysis: all missing type annotations fixed (was 40/50 → targeting 50/50).

---

1.0.11

Updated

• fixed documentation link

1.0.10

Updated

• fixed linting errors

1.0.9

Updated

• Added Dialog in the widget Catalog
• example app is updated with dialog widget

1.0.8

Updated

• Added Three Toasts Styles .
• fixed file name Convention
• withOpacity is replaced with withValue
• example app is updated with all the widgets

1.0.7

Updated

• Added Diffrent Buttons Styles .

1.0.6

Updated

• Updated MaterialStateProperty(deprecated) to WidgetStateProperty .

1.0.5

Added

• Added new widget 'Sparkle Text'.

1.0.4

Added

• Added new widget AuraUICarouselTappable with onTap functionality.

1.0.3

-Added Buttons in the Catalog

• AuiIconButton
• AuiLoadingButton
• AuiSimpleButton