mobintix_ui_kit 0.0.2

A configurable, theme-driven Flutter UI kit with responsive breakpoints, design tokens, accessibility, and 50+ production-ready widgets.

Changelog

All notable changes to the mobintix_ui_kit module will be documented in this file.

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

0.0.2 - 2026-03-20

Changed

• Mobintix brand theme — Primary and secondary colors now match mobintix.com (vibrant blue #4361EE, warm orange #E8853D). Light and dark palettes updated across all semantic, surface, and text colors.
• Example app landing page — Redesigned with gradient hero header, responsive category grid (2/3/4 columns), stat chips, and widget count badges.
• WidgetShowcase system — Every example screen now shows the actual Dart class name, a collapsible copy-paste code snippet, and a live widget demo.
• All 15 example screens updated with WidgetShowcase and PackageImportBanner.
• Barrel file (lib/mobintix_ui_kit.dart) — Comprehensive dartdoc listing every widget organized by category with usage examples.
• README.md — Full widget catalog table (50+ widgets with counts), updated usage examples, testing section, and corrected repository URL.
• CHANGELOG.md — Detailed per-category widget breakdown.

0.0.1 - 2026-03-20

Added

Theme System

• AppTheme — Root token container with light, dark, and JSON-driven factories.
• AppColors — Brand, semantic, surface, and text colors with copyWith and toJson.
• AppTypography — Font family, sizes, line heights, letter spacing, 15 text style getters.
• AppSpacing — xxs through xxxl spacing tokens.
• AppRadius — Border radius tokens (xs through full).
• AppShadows — Box shadow definitions (sm, md, lg).
• AppDurations — Animation duration tokens (fast, normal, slow, pageTransition).
• AppSizing — Button heights, icon sizes, avatar sizes, dialog dimensions.
• AppThemeScope — InheritedWidget for dependency-free theme injection.
• ThemeBuilder — Convenience widget for theme-aware building.
• Responsive — 5-tier breakpoint utility (xs/sm/md/lg/xl).
• ResponsiveBuilder widget and ResponsiveContext extensions.
• AppTextStyleContext extension for quick TextStyle access from BuildContext.

Buttons (3 widgets)

• AppButton — Primary, secondary, outline, ghost, danger variants with loading state.
• AppIconButton — Icon-only action button.
• AppTextButton — Text-only action button.

Inputs (5 widgets)

• AppTextField / PasswordTextField — Themed text inputs with validation.
• PinInput — PIN/OTP entry field.
• SearchField — Search input with clear action.
• PhoneField — International phone number input.

Selection Controls (7 widgets)

• AppSwitch — Themed toggle switch with label.
• AppCheckbox — Themed checkbox with tristate support.
• AppRadioGroup — Themed radio button group.
• AppDropdown — Themed dropdown selector.
• AppChip / AppChipGroup — Filter and selection chips.
• AppSegmentedControl — Segmented toggle button group.

Pickers & Sliders (5 widgets)

• AppDatePicker — Themed date selection field.
• AppTimePicker — Themed time selection field.
• AppSlider / AppRangeSlider — Themed value and range sliders.
• AppRatingBar — Star rating input and display.

Cards (3 widgets)

• AppCard — Base themed card with tap support.
• InfoCard — Key-value display card.
• ListDetailCard — Configurable list-detail row card.

Layout (9 widgets)

• VSpace / HSpace — Vertical and horizontal spacing.
• SafeContent — Safe area content wrapper.
• AppAppBar — Themed app bar.
• AppListTile — Configurable list item with divider support.
• AppExpansionTile — Themed collapsible accordion section.
• SectionHeader — Title with optional "See All" action.
• ResponsiveGrid — Breakpoint-aware grid layout.
• GradientContainer — Themed gradient background wrapper.

Navigation (2 widgets)

• AppTabBar — Themed tab bar with indicators.
• AppBottomNavBar — Themed bottom navigation bar.

Feedback (11 widgets)

• LoadingIndicator / LoadingOverlay — Themed loading states.
• EmptyState / ErrorState — Placeholder states with actions.
• showAppToast — Toast notification utility.
• AppProgressBar — Linear progress (determinate / indeterminate).
• AppSnackBar — Semantic snackbar variants (success, error, warning, info).
• AppBanner — Inline alert banner with dismissal.
• AppStepper — Horizontal multi-step progress indicator.
• AppSkeleton / AppSkeletonParagraph — Animated skeleton loading placeholders.

Dialogs (4 widgets)

• showAppDialog / AppDialog — Custom themed dialogs.
• showConfirmDialog — Confirmation dialog with actions.
• showAppBottomSheet — Themed bottom sheet with options.

Media (3 widgets)

• AppImage — Themed network/asset image with placeholder.
• AppAvatar / StatusAvatar — Avatar with optional presence badge.

Typography (1 widget)

• AppText — All Material 3 text styles as named constructors.

Misc (11 widgets)

• AppDivider / DividerWithText / AppVerticalDivider — Themed dividers.
• AppBadge / NotificationBadge — Badge overlays.
• ShimmerLoading — Shimmer skeleton loading.
• AppPopupMenu — Themed popup menu.
• AppTooltip — Themed tooltip wrapper.
• AnimatedCounter — Smooth number transitions.
• AppStatusIndicator — Presence status dot (online/offline/busy/away).
• AppClipboardCopy — Tap-to-copy with visual feedback.
• AppCountdownTimer — Countdown display with auto-start.

Testing & Quality

• 175+ widget tests across all components.
• Test helpers with wrapWithTheme for consistent test setup.
• analysis_options.yaml with strict lint rules.
• Zero lint warnings.

Example App

• 15-screen showcase app with category-based navigation.
• Demonstrates every widget with interactive examples.
• Dark/light mode toggle.
• Responsive grid landing page.