🧠 Major Feature: Intelligent Auto-Configuration #

Added

• Intelligent Scale Limit Auto-Detection: Package now automatically determines optimal minScale and maxScale based on device type, screen size, orientation, and aspect ratio
  • Mobile phones: 0.85-1.15x (portrait), 0.85-1.25x (landscape)
  • Tablets: 0.8-1.3x (portrait), 0.75-1.4x (landscape)
  • Desktop/Web: 0.6-2.0x (landscape), 0.7-1.8x (portrait)
  • Special handling for foldables, ultra-wide monitors (>2560px), small windows (<800px), and notched screens
  • Automatically adjusts limits when mobile designs run on tablets/desktop
• Zero-Configuration Setup: minScale and maxScale parameters are now optional (nullable) - pass null to enable auto-detection (recommended for 95% of use cases)
• Manual Override Toggle: Example app now includes "Manual Scale Control" switch in settings to toggle between auto-detection and manual configuration
• Live Scale Preview: Settings UI displays real-time scale calculations showing:
  • Current device type (Mobile/Tablet/Desktop) with badge
  • Orientation (Portrait/Landscape)
  • Auto-detected scale range (e.g., "Auto: 0.85-1.15x")
  • Raw scale vs clamped scale comparison with color coding
  • Active clamping warnings
  • Example calculations (e.g., "100.w = 125px")

Documentation

• New "Intelligent Auto-Configuration" Section in README (prominently placed after screenshots):
  • Two-column layout explaining what the package auto-detects and optimizes
  • Zero-configuration code example
  • Clear guidance on when manual configuration is needed (edge cases only)
• Enhanced "Understanding Scale Limits" Section:
  • Step-by-step math examples with real device scenarios
  • Updated use case table focusing on manual override scenarios
  • Added reminder that auto-detection handles most cases
• New "Understanding Orientation Boosts" Section with comprehensive documentation:
  • Complete scaling formulas for sizes and fonts
  • Default boost table for all device types and orientations
  • Real-world step-by-step math example (iPhone 14 landscape)
  • Three practical use cases with code examples (Dense dashboards, Reading apps, Kiosk tablets)
  • Complete working example with inline math breakdowns
  • Six key takeaways explaining boost behavior
• Inline Code Documentation:
  • Added detailed comment blocks in main.dart explaining intelligent auto-configuration
  • Added orientation boost explanation with math examples
  • All boost parameters now include their default values in comments
• Key Features Section: Added intelligent auto-configuration as a highlighted feature at the top of README

Changed

• minScale and maxScale parameters in ScaleKitBuilder are now nullable (double?) instead of required
• Example app defaults to null for both scale limits, enabling intelligent auto-detection
• Enhanced _getScaleLimits() algorithm in ScaleManager with:
  • Orientation-aware limits (landscape gets wider ranges)
  • Aspect ratio detection (narrow/standard/wide)
  • Design-to-screen ratio analysis
  • Special case handling for edge scenarios
• Settings UI now clearly indicates when auto-detection is active vs manual override:
  • Green "Auto-Intelligent" badge when using auto-detection
  • Orange "Manual Override" badge when using manual limits
  • Dynamic subtitle showing current mode

Fixed

• Removed unused _useManualScaleLimits field from example app (was causing linter warning)
• Settings sheet now properly handles null scale values throughout the UI

Technical Improvements #

• Enhanced ScaleManager._getScaleLimits() with 90+ lines of intelligent detection logic
• Settings preview builder now calculates and displays auto-detected values
• Scale limits are computed dynamically based on current screen state
• Manual override properly restores to null values when disabled

Added #

• GitHub Pages deployment workflow for hosting live web demo
• Live web demo link in README for easy access to interactive example
• GitHub Actions workflow for automated web app deployment (manual trigger)

Changed #

• Updated GitHub Actions workflow to use Flutter 3.29.2
• Web demo deployment is now manual-only to prevent unnecessary builds

Fixed #

• Documentation improvements for GitHub Pages setup

Changed #

• Example Android: set ndkVersion to r28 to support 16 KB memory page size requirement
• Settings UX: Save now force-applies changes (disable → short wait → enable) and rebuilds
• Settings UI: buttons use Row aligned end (Wrap fallback on compact), controls hide/show based on toggles

Fixed #

• Avoid overflow in settings action area on small screens
• Hide settings action when scaling is disabled

Added #

• SKResponsiveBuilder widget with dual usage patterns:
  • Builder pattern: main builder that receives (context, device, orientation)
  • Device-specific builders: optional mobile, tablet, desktop, mobileLandscape, tabletLandscape, desktopLandscape (similar to SKResponsive)
• Improved fallback logic for SKResponsive: mobileLandscape now falls back to mobile, tabletLandscape falls back to tablet then mobileLandscape then mobile

Changed #

• SKResponsive fallback order: tabletLandscape ?? tablet ?? mobileLandscape ?? mobile (more intuitive)
• SKResponsiveBuilder: device-specific builders take priority over main builder when both are provided

Fixed #

• Fixed formatting issues in scale_value_factory.dart to match Dart formatter

Fixed #

• Removed dangling library doc comment (changed to regular comment)
• Fixed formatting issues in aspect_ratio_adapter.dart and all lib files
• Removed .pubignore to include example folder (pub.dev requirement)

Added #

• Complete dartdoc documentation for all public API symbols:
  • AspectRatioAdapter constructor documentation
  • DeviceDetector constructor documentation
  • FontConfig.instance getter documentation
  • HSpace constructor documentation
  • LanguageFontConfig constructor documentation

Changed #

• All library files formatted with dart format for consistency
• Example folder now included in published package (required by pub.dev)

Fixed #

• Pub.dev compliance: shortened description (60–180 chars), removed library declaration, replaced deprecated Color.value
• Added pub badges, topics, platforms, screenshots, issue tracker and documentation links
• Exclude example from publish via .pubignore

Changed #

• Docs refinements and export additions (no breaking API changes)

Added #

• SKResponsive widget for device/orientation-aware builders with sensible fallbacks
• SKit.responsiveInt() and SKit.responsiveDouble() for responsive integer/double resolution (e.g., Grid columns)
• SKit.columns() alias for responsiveInt() for grid layouts
• DesktopAs enum to control how desktop resolves (desktop/tablet/mobile) for CSS-like breakpoints
• Device detection: desktop classified strictly by width ≥ 1200 (Android/iOS remain mobile/tablet by width)
• Desktop can optionally mimic tablet/mobile values using desktopAs parameter
• Example app section demonstrating responsive builder and columns usage
• README updates: Responsive Builder & Columns section with DesktopAs examples and CSS-like behavior notes
• Pub badges (version, likes, points, popularity) and CTA in README
• Pub.dev metadata: topics, platforms, screenshots, issue_tracker, documentation links

Changed #

• Desktop behavior: treated as single form by default; can opt-in to tablet/mobile behavior via desktopAs
• Android/iOS: devices classified only as mobile/tablet by width; desktop logic doesn't apply
• README: added DesktopAs documentation and CSS-like grid examples
• Package description shortened to 169 characters (within pub.dev 60-180 range)

Fixed #

• Removed unnecessary library declaration (library flutter_scale_kit;)
• Replaced deprecated Color.value with Color.toARGB32() for cache key generation
• Added .pubignore to exclude example folder from published package

Added #

• Orientation-specific autoscale flags: autoScaleLandscape (default true), autoScalePortrait (default false)
• Portrait font/size boosts per device type (mobile/tablet/desktop)
• Global enable/disable scaling with runtime toggle via enabled and enabledListenable
• Example app settings sheet to live-test autoscale and boosts, with Save/Cancel and Reset to defaults
• Device detection updated: Android/iOS (including emulators) are mobile/tablet by width; desktop only for desktop OS; web distinct
• README updates: Orientation Autoscale, Runtime Toggle sections; added screenshots and guidance

Fixed #

• MaterialLocalizations error when opening settings (uses proper in-app context)
• Overflow in demo card: text now wraps/scales to avoid RenderFlex overflows

Changed #

• Example made more professional and explanatory for all package parts

Fixed #

• Fixed borderRadius error when using different border colors on individual sides
• Fixed Localizations error when context doesn't include Localizations ancestor
• Made FontConfig a proper singleton with instance getter
• Fixed all lint warnings for local variables starting with underscore

Added #

• Font configuration system with automatic font selection per language
• Support for Google Fonts and custom font families
• Automatic font application to all TextStyles
• Language group font configuration
• Safe Localizations access with fallback to default language
• Default font fallback (uses Flutter's default font if no configuration provided)
• FontConfig class for managing fonts per language
• LanguageFontConfig and LanguageGroupFontConfig for font configuration
• TextStyle extensions for automatic font application
• Screenshots for mobile, tablet, and desktop devices

Changed #

• FontConfig now uses singleton pattern with FontConfig.instance
• All TextStyle creation methods automatically apply FontConfig
• ThemeData integration now includes automatic font configuration
• Improved error handling for missing Localizations context
• Updated README with side-by-side mobile and tablet screenshots

Added #

• Initial release of Flutter Scale Kit
• Extension methods for easy scaling (.w, .sw, .sh, .r, .sp, .h)
• ScaleKitBuilder widget for app-level responsive configuration
• SKit helper class with convenient methods for creating widgets
• Size system with predefined enums (SKSize, SKTextSize)
• Centralized theme configuration with SKitTheme
• Individual border side support for containers (top, bottom, left, right)
• Border color and width customization per side
• Context extensions for responsive scaling
• Device detection utilities (mobile, tablet, desktop)
• ThemeData integration for responsive themes
• Intelligent caching system for optimal performance
• Const-compatible widgets (SKPadding, SKContainer, SKMargin, HSpace, VSpace, SSpace)
• Helper properties similar to flutter_screenutil (pixelRatio, screenWidth, screenHeight, etc.)
• Size configuration system with default values
• Custom size values for padding, margin, radius, spacing, and text sizes

Features #

• High-performance responsive design with intelligent caching
• Flyweight pattern for value reuse
• Factory pattern for creating scaled values
• Singleton pattern for global scale management
• Automatic cache invalidation on size/orientation changes
• Device-specific scaling strategies
• Aspect ratio adaptation for various device types
• Orientation-aware font scaling (20% boost for mobile landscape)
• Threshold-based size change detection (5% threshold)

Performance #

• Caching system prevents recalculation on every rebuild
• Only recalculates on significant size or orientation changes
• Const-compatible widgets for better performance
• Optimized widget rebuilds