Added - Advanced Features #

Responsive Extensions

• Breakpoint system: xs, sm, md, lg, xl, xxl
• Show/hide utilities: showOnXs(), hideOnMd(), lgAndUp(), etc.
• Responsive padding/width: responsivePadding(), responsiveWidth()
• ResponsiveBuilder widget for custom responsive layouts

Grid System

• CSS Grid-like layout: gridCols1() - gridCols6(), gridAutoFit(), gridAutoFill()
• Responsive grid: gridResponsive(xsCols, smCols, mdCols, lgCols)
• Grid item extensions: gridColSpan(), gridRowSpan(), gridArea()
• AwGrid and AwResponsiveGrid widgets

Gradient Extensions

• Linear gradients: gradientToR(), gradientToL(), gradientToT(), gradientToB()
• Radial gradient: gradientRadial()
• Sweep gradient: gradientSweep()
• Preset gradients: gradientSunset(), gradientOcean(), gradientForest(), gradientNeon(), gradientRose(), gradientGold()
• Gradient text support

Animation Extensions

• Entry animations: fadeIn(), fadeOut(), slideInLeft(), slideInRight(), slideInUp(), slideInDown(), scaleIn()
• Continuous animations: spin(), bounce(), pulse(), shake()
• Interactive animations: tapScale(), tapOpacity(), hoverScale(), hoverElevate()

Dark Mode Extensions

• Theme-aware backgrounds: themeBackground(), darkBgGray900(), lightBgWhite()
• Theme-aware text: darkTextWhite(), lightTextGray900()
• Theme widgets: ThemeAware, ThemeContainer, ThemeText, ThemeIcon

Gesture Extensions

• Tap handlers: onTap(), onDoubleTap(), onLongPress()
• Hover callbacks: onHover()
• Cursor utilities: cursorPointer(), cursorGrab(), cursorText()
• Drag support: draggable(), swipeToDelete()
• Scroll utilities: scrollable(), scrollX(), scrollY()

Typography Presets

• Headings: h1() - h6()
• Body text: bodyLarge(), bodyBase(), bodySmall()
• Labels: label(), labelLarge(), labelSmall()
• Display: displayLarge(), displayMedium(), displaySmall()
• Special: caption(), quote(), code(), overlineText()
• Text transform: uppercase(), lowercase(), capitalize()

Button Presets

• Primary buttons: btnPrimary(), btnPrimaryLg(), btnPrimarySm()
• Variants: btnSecondary(), btnOutline(), btnGhost(), btnDanger(), btnSuccess(), btnWarning()
• Special: btnPill(), btnLink(), btnGradient(), btnLoading(), btnDisabled()
• Icon buttons: btnIconCircle(), btnIconFilled(), btnIconOutline()
• AwButton widget with variants and sizes

Card Presets

• Basic cards: card(), cardBordered(), cardElevated(), cardFlat()
• Interactive: cardHoverable(), cardClickable()
• Colored: cardPrimary(), cardDanger(), cardSuccess(), cardWarning(), cardInfo()
• Gradient: cardGradient()
• Special: cardWithHeader(), cardWithFooter(), cardGlass(), cardLeftBorder()
• AwCard widget

Custom Value Extensions

• Custom colors: bg(), bgHex('#0f172a'), bgColor(0xFF0f172a), bgRgb(), bgRgba()
• Custom text colors: textColor(), textHex(), textRgb()
• Custom spacing: pCustom(), mCustom(), pxCustom(), pyCustom(), pTRBL()
• Custom sizing: wCustom(), hCustom(), wPercent(), hPercent(), square()
• Custom decoration: roundedCustom(), borderCustom(), borderHex(), shadowCustom()
• Custom typography: fontSize(), fontW(), letterSpacingCustom(), lineHeight()
• Custom transform: rotateCustom(), scaleCustom(), translateCustom()
• AwCustom utility class for creating colors, padding, radius, shadows

Advanced Flex Extensions

• Flex utilities: flexRow(), flexCol(), flexWrap(), flexReverse()
• Justify content: justifyStart(), justifyEnd(), justifyCenter(), justifyBetween(), justifyAround(), justifyEvenly()
• Align items: itemsStart(), itemsEnd(), itemsCenter(), itemsStretch()
• Flex item: flexGrow(), flexShrink(), flexNone(), flexInitial()

Changed #

• Updated extension count from 500+ to 800+
• Improved documentation with new examples

Improved #

• Added dartdoc comments to 230+ public API elements for better documentation coverage
• Fixed Dart formatting issues across all source files
• Fixed sized_box_for_whitespace lint warning in example

Documentation #

• ColorExtensions: All 113 background color methods now have dartdoc comments
• TextColorExtensions: All 48 text color methods now have dartdoc comments
• SpacingExtensions: All 74 padding/margin methods now have dartdoc comments
• Documentation coverage increased from 8.8% to 20%+

Changed #

• Removed Tailwind CSS branding from package description and documentation
• Updated package description to focus on Awaitware UI Utilities as a standalone toolkit
• Improved example app with comprehensive UI demonstrations
• Updated all documentation to reflect modern utility-first approach

Documentation #

• Refreshed README with updated branding
• Updated library documentation comments
• Enhanced example application

Added #

Core Features

• 500+ extension methods for Flutter widgets inspired by Tailwind CSS
• Chainable API for clean, readable UI code
• Zero dependencies (only requires Flutter SDK)
• Full Dart type safety with IDE autocomplete support

Extension Categories

1. Spacing Extensions (90+ methods)

• Padding utilities: p0() through p96() with directional variants (px, py, pt, pr, pb, pl)
• Margin utilities: m0() through m96() with directional variants (mx, my, mt, mr, mb, ml)
• Auto margin for centering: mxAuto(), myAuto()

2. Color Extensions (200+ methods)

• Background colors for all Material color shades: bgRed50() through bgRed900(), etc.
• Text colors for all Material color shades: textRed50() through textRed900(), etc.
• Support for: Red, Pink, Purple, Deep Purple, Indigo, Blue, Light Blue, Cyan, Teal, Green, Light Green, Lime, Yellow, Amber, Orange, Deep Orange, Brown, Grey, Blue Grey
• Special colors: bgBlack(), bgWhite(), bgTransparent()

3. Typography Extensions (60+ methods)

• Font sizes: textXs() (12px), textSm() (14px), textBase() (16px), textLg() (18px), textXl() (20px), text2Xl() (24px), text3Xl() (30px), text4Xl() (36px), text5Xl() (48px)
• Font weights: fontThin(), fontLight(), fontNormal(), fontMedium(), fontSemibold(), fontBold(), fontBlack()
• Text alignment: textLeft(), textCenter(), textRight(), textJustify()
• Text decoration: underline(), lineThrough(), noDecoration()
• Text overflow: ellipsis(), clip(), fade()
• Letter spacing: trackingTighter(), trackingNormal(), trackingWider(), etc.
• Line height: leadingNone(), leadingTight(), leadingNormal(), leadingLoose()
• Font styles: italic(), notItalic()

4. Sizing Extensions (50+ methods)

• Width utilities: w0() through w96(), wFull(), wScreen()
• Height utilities: h0() through h96(), hFull(), hScreen()
• Size utilities: size0() through size96() (equal width and height)
• Icon sizes: size16(), size24(), size32(), size48(), size64()
• Max width: maxWXs(), maxWSm(), maxWMd(), maxWLg(), maxWXl(), etc.
• Max height: maxHScreen(), maxHFull()
• Min width/height: minWFull(), minHFull(), minHScreen()

5. Decoration Extensions (40+ methods)

• Border radius: rounded(), roundedSm(), roundedMd(), roundedLg(), roundedXl(), rounded2Xl(), rounded3Xl(), roundedFull()
• Directional radius: roundedTSm(), roundedRLg(), etc.
• Borders: border(), border2(), border4(), border8()
• Border colors: borderRed600(), borderBlue600(), etc. (all Material colors)
• Directional borders: borderT(), borderR(), borderB(), borderL()
• Box shadows: shadowSm(), shadow(), shadowMd(), shadowLg(), shadowXl(), shadow2Xl(), shadowNone()
• Opacity: opacity0(), opacity25(), opacity50(), opacity75(), opacity100()

6. Layout Extensions (30+ methods)

• Alignment: center(), alignTopLeft(), alignCenter(), etc.
• Expansion: expanded(), flexible(), expanded2(), expanded3()
• Aspect ratios: aspectSquare(), aspectVideo(), aspect16x9(), aspect4x3(), etc.
• Constraints: constrained(), unconstrained()
• Scrolling: scrollable(), scrollableX(), scrollableY()
• Fitted box: fitted(), contain(), cover(), fill(), scaleDown()
• Clip behavior: clipRect(), clipRRect(), clipOval(), clipPath()

7. Flex Extensions (20+ methods)

• List to Row: row(), rowReverse()
• List to Column: column(), columnReverse()
• List to Stack: stack()
• List to Wrap: wrap(), wrapSpacing()
• Gap utilities: gap(), gapV(), gapH()
• Main axis alignment: spaceBetween(), spaceAround(), spaceEvenly(), mainStart(), mainEnd(), mainCenter()
• Cross axis alignment: crossStart(), crossEnd(), crossCenter(), crossStretch()

8. Transform Extensions (15+ methods)

• Rotation: rotate45(), rotate90(), rotate180(), rotate270()
• Scaling: scale50(), scale75(), scale90(), scale95(), scale100(), scale105(), scale110(), scale125(), scale150()
• Translation: translateX(), translateY()
• Flipping: flipH(), flipV()

9. Positioning Extensions (10+ methods)

• Absolute positioning: absolute(), positioned()
• Position utilities: top0(), right0(), bottom0(), left0()
• Fill positioning: positionFill(), inset0()

10. Visibility Extensions (6+ methods)

• Conditional visibility: show(), hide()
• Opacity-based: visible(), invisible()
• Offstage: offstage()
• Pointer events: ignorePointer(), absorbPointer()

Helper Class (aw)

Widget Creators

• aw.text() - Create Text widget
• aw.container() - Create Container widget
• aw.box() - Container with child
• aw.icon() - Create Icon widget

Layout Builders

• aw.row() - Create Row
• aw.column() - Create Column
• aw.stack() - Create Stack
• aw.wrap() - Create Wrap

Spacing Helpers

• aw.spaceV() - Vertical spacing
• aw.spaceH() - Horizontal spacing
• aw.space1() through aw.space8() - Tailwind-scale spacing

Pre-styled Components

• aw.button() - Styled button
• aw.card() - Card with shadow
• aw.divider() - Horizontal divider
• aw.verticalDivider() - Vertical divider

Images

• aw.imageNetwork() - Network image
• aw.imageAsset() - Asset image

Utility Helpers

• aw.empty() - Empty SizedBox
• aw.expanded() - Expanded widget
• aw.center() - Center widget
• aw.padding() - Padding widget

Documentation #

• Comprehensive README.md with examples
• Quick Start Guide
• Installation Guide
• Contributing Guide
• Publishing Checklist
• Complete API reference with 500+ utilities documented

Examples #

• Working example app demonstrating key features
• Code examples for all extension categories

Performance #

• Lightweight extensions with minimal overhead
• Optimized for production use
• Zero runtime dependencies

Developer Experience #

• Full IDE autocomplete support
• Type-safe API
• IntelliSense-friendly
• Clear error messages

---

Planned Features #

• Animation utilities
• Gradient utilities
• Custom theme support
• Dark mode utilities
• Responsive utilities

---

Note: This is the initial release of Awaitware UI Utilities. Future updates will be documented here.