This is a major release that re-engineers the core scaling engine, introduces powerful developer experience improvements, and brings the following:

• Advanced: Added observeMetrics to ScalifyProvider to prevent race conditions in nested providers (fixes resize lag).
• Example: Added comprehensive ScalifySection demo with split-view, nested navigation, and best practices guide.
• Tests: Reached 208 passing tests.

⚡ Core Engine Overhaul #

• InheritedModel with ScalifyAspect: Replaced global subscription with granular aspects (type, scale, text). Widgets that only need screen type information won't rebuild when scale changes, massively reducing unnecessary rebuilds.
• Quantized IDs (Jitter Prevention): Internal float-to-int conversion (×1000) for InheritedModel aspect equality checks. Eliminates phantom rebuilds caused by microscopic floating-point differences.
• Configurable Rebuild Tolerance: ResponsiveData.== now uses rebuildScaleThreshold (default 0.01) for scale comparisons and rebuildWidthPxThreshold (default 4.0px) for size comparisons, giving users control over rebuild sensitivity.
• Active Debounce: debounceWindowMillis is now actively implemented via Timer in ScalifyProvider. Platform-driven events (resize, text scale) are debounced while parent-driven updates remain synchronous.
• Balanced scaleFactor: Now uses math.min(scaleWidth, scaleHeight) to prevent UI overstretching on non-standard aspect ratios.
• Modern textScaler: Replaced deprecated textScaleFactor with Flutter 3.x textScaler API for full Material 3 and accessibility compliance.
• ContainerQueryData Tolerance: Added 0.5px sub-pixel tolerance to ContainerQueryData.== to prevent unnecessary rebuilds from fractional pixel differences.

🎨 Developer Experience (DX) #

• Builder Pattern in ScalifyProvider: Added optional builder property. Place ScalifyProvider as parent of MaterialApp to prevent cascading rebuilds on window resize.
• ScalifySection Widget: New widget for split-screen/master-detail patterns. Creates an independent scaling context based on the section's actual layout width, not the full screen width. Essential for sidebar + content layouts.
• ScalifyBuilder Deprecated: Unified builder widgets — use ResponsiveBuilder instead. ScalifyBuilder remains as a backward-compatible alias.
• Context API for const Widgets: Added context.w(), context.h(), context.r(), context.sp() methods. Ensures responsive values update even inside const widget trees.
• Percentage Scaling: Added .pw (% of screen width) and .hp (% of screen height) extensions.
• Deprecation Banner Fix: The _DeprecationBanner now renders inside the MaterialApp context when using the builder pattern, fixing the crash caused by missing Material ancestors.

🔧 Component Improvements #

• ContainerQuery Performance: Fully relies on LayoutBuilder instead of global MediaQuery. No longer triggers rebuilds from keyboard appearance or system-level changes. Added tolerance threshold to prevent jitter on onChanged.
• AppWidthLimiter Upgrades: Added minWidth for automatic horizontal scrolling on tiny windows. Added RepaintBoundary for 50% performance improvement during window dragging on weak devices.
• ResponsiveGrid Caching: Converted to StatefulWidget with cached SliverGridDelegate, preventing recalculation on every frame during scroll/resize.
• autoSwapDimensions: New config option that automatically swaps designWidth/designHeight in landscape mode.

🧹 Code Quality #

• Removed 90+ lines of dead code, zombie comments, and disabled features.
• Fixed valueByScreen fallback: Now correctly cascades from largeDesktop → desktop → tablet → mobile instead of skipping tiers.
• Assert everywhere: Added debug assertions for negative scales, invalid configs, and missing providers.

📚 Documentation #

• Enhanced GlobalResponsive docs: Clarified singleton design, nested provider behavior, and added @visibleForTesting reset() method.
• Enhanced AppWidthLimiter docs: Documented MediaQuery override behavior, RepaintBoundary rationale, and minWidth scrolling.
• Enhanced ResponsiveHelper.fromContext docs: Added note about default config behavior.
• Enhanced ResponsiveBuilder docs: Added usage example and clarified it's the primary builder widget.
• Complete README rewrite with comparison tables, full API cheat sheet, all widget examples, ScalifyConfig reference, migration guide, and advanced engine internals.
• Updated CHANGELOG with comprehensive v3.0.0 release notes.

🧪 Test Suite #

• 208 tests passing with optimized test infrastructure.
• Replaced pumpAndSettle() with targeted pump() for 10× faster test execution.
• Added pumpApp() helper that correctly handles ScalifyProvider's debounce timer.
• All tests use the recommended builder pattern (ScalifyProvider as parent of MaterialApp).

⚠️ Breaking Changes & Rebranding #

• Renamed Provider: ResponsiveProvider is now ScalifyProvider. This aligns with the package name and avoids conflicts with other libraries.
• Renamed Config: ResponsiveConfig is now ScalifyConfig.

🎨 Theme Integration #

• Added ScalifyThemeExtension: You can now scale your entire app's text theme in one line using ThemeData.light().scale(context).
  • Smart Optimization: It automatically checks if the scale factor is 1.0 to avoid unnecessary calculations.
  • Result: No need to add .fz manually to every text widget anymore if you use the global theme!

🧠 New Logic Widgets #

• Added ResponsiveVisibility: A powerful widget to conditionally show or hide elements based on screen type.
  • Supports visibleOn (Whitelist) and hiddenOn (Blacklist).
  • Includes assertions to ensure you don't use both lists simultaneously.
• Added ResponsiveLayout: Effortlessly switch between portrait and landscape layouts using a clean API.
• Added ResponsiveBuilder: A direct way to access ResponsiveData inside the widget tree via a builder pattern, simplifying complex logic.

📚 Documentation #

• Complete Overhaul: The README has been rewritten to feature a "Why Scalify?" comparison table, better examples, and clearer categorization of features.

Maintenance: Clean up project structure (removed unused platform folders from root). Improvement: Enhanced project organization. This major update focuses on standardizing the package architecture, improving Developer Experience (DX), and adding powerful logic controls to your UI.

⚠️ Breaking Changes & Rebranding #

• Renamed Provider: ResponsiveProvider is now ScalifyProvider. This aligns with the package name and avoids conflicts with other libraries.
• Renamed Config: ResponsiveConfig is now ScalifyConfig.

🎨 Theme Integration #

• Added ScalifyThemeExtension: You can now scale your entire app's text theme in one line using ThemeData.light().scale(context).
  • Smart Optimization: It automatically checks if the scale factor is 1.0 to avoid unnecessary calculations.
  • Result: No need to add .fz manually to every text widget anymore if you use the global theme!

🧠 New Logic Widgets #

• Added ResponsiveVisibility: A powerful widget to conditionally show or hide elements based on screen type.
  • Supports visibleOn (Whitelist) and hiddenOn (Blacklist).
  • Includes assertions to ensure you don't use both lists simultaneously.
• Added ResponsiveLayout: Effortlessly switch between portrait and landscape layouts using a clean API.
• Added ResponsiveBuilder: A direct way to access ResponsiveData inside the widget tree via a builder pattern, simplifying complex logic.

📚 Documentation #

• Complete Overhaul: The README has been rewritten to feature a "Why Scalify?" comparison table, better examples, and clearer categorization of features.

This major update focuses on standardizing the package architecture, improving Developer Experience (DX), and adding powerful logic controls to your UI.

⚠️ Breaking Changes & Rebranding #

• Renamed Provider: ResponsiveProvider is now ScalifyProvider. This aligns with the package name and avoids conflicts with other libraries.
• Renamed Config: ResponsiveConfig is now ScalifyConfig.

🎨 Theme Integration #

• Added ScalifyThemeExtension: You can now scale your entire app's text theme in one line using ThemeData.light().scale(context).
  • Smart Optimization: It automatically checks if the scale factor is 1.0 to avoid unnecessary calculations.
  • Result: No need to add .fz manually to every text widget anymore if you use the global theme!

🧠 New Logic Widgets #

• Added ResponsiveVisibility: A powerful widget to conditionally show or hide elements based on screen type.
  • Supports visibleOn (Whitelist) and hiddenOn (Blacklist).
  • Includes assertions to ensure you don't use both lists simultaneously.
• Added ResponsiveLayout: Effortlessly switch between portrait and landscape layouts using a clean API.
• Added ResponsiveBuilder: A direct way to access ResponsiveData inside the widget tree via a builder pattern, simplifying complex logic.

📚 Documentation #

• Complete Overhaul: The README has been rewritten to feature a "Why Scalify?" comparison table, better examples, and clearer categorization of features.

This major update focuses on standardizing the package architecture, improving Developer Experience (DX), and adding powerful logic controls to your UI.

⚠️ Breaking Changes & Rebranding #

• Renamed Provider: ResponsiveProvider is now ScalifyProvider. This aligns with the package name and avoids conflicts with other libraries.
• Renamed Config: ResponsiveConfig is now ScalifyConfig.

🎨 Theme Integration #

• Added ScalifyThemeExtension: You can now scale your entire app's text theme in one line using ThemeData.light().scale(context).
  • Smart Optimization: It automatically checks if the scale factor is 1.0 to avoid unnecessary calculations.
  • Result: No need to add .fz manually to every text widget anymore if you use the global theme!

🧠 New Logic Widgets #

• Added ResponsiveVisibility: A powerful widget to conditionally show or hide elements based on screen type.
  • Supports visibleOn (Whitelist) and hiddenOn (Blacklist).
  • Includes assertions to ensure you don't use both lists simultaneously.
• Added ResponsiveLayout: Effortlessly switch between portrait and landscape layouts using a clean API.
• Added ResponsiveBuilder: A direct way to access ResponsiveData inside the widget tree via a builder pattern, simplifying complex logic.

📚 Documentation #

• Complete Overhaul: The README has been rewritten to feature a "Why Scalify?" comparison table, better examples, and clearer categorization of features.

This major update focuses on standardizing the package architecture, improving Developer Experience (DX), and adding powerful logic controls to your UI.

⚠️ Breaking Changes & Rebranding #

• Renamed Provider: ResponsiveProvider is now ScalifyProvider. This aligns with the package name and avoids conflicts with other libraries.
• Renamed Config: ResponsiveConfig is now ScalifyConfig.

🎨 Theme Integration #

• Added ScalifyThemeExtension: You can now scale your entire app's text theme in one line using ThemeData.light().scale(context).
  • Smart Optimization: It automatically checks if the scale factor is 1.0 to avoid unnecessary calculations.
  • Result: No need to add .fz manually to every text widget anymore if you use the global theme!

🧠 New Logic Widgets #

• Added ResponsiveVisibility: A powerful widget to conditionally show or hide elements based on screen type.
  • Supports visibleOn (Whitelist) and hiddenOn (Blacklist).
  • Includes assertions to ensure you don't use both lists simultaneously.
• Added ResponsiveLayout: Effortlessly switch between portrait and landscape layouts using a clean API.
• Added ResponsiveBuilder: A direct way to access ResponsiveData inside the widget tree via a builder pattern, simplifying complex logic.

📚 Documentation #

• Complete Overhaul: The README has been rewritten to feature a "Why Scalify?" comparison table, better examples, and clearer categorization of features.

This update transforms Scalify from a "Scaling Engine" into a full "Responsive Layout System". It introduces powerful widgets to handle complex layouts on Web and Desktop without manual math.

📐 New Feature: The Responsive Layout System #

• Added ResponsiveGrid: The ultimate grid solution.
  • 6-Tier Support: Now supports specific column counts for Watch, Mobile, Tablet, Small Desktop (New), Desktop, and Large Desktop (New).
  • Auto-Fit Mode: Just provide a minItemWidth (e.g., 150px), and the grid will automatically calculate how many items fit in the row. Perfect for API data.
  • Lazy Loading: Built-in support for SliverGrid and infinite scrolling performance.
• Added ResponsiveFlex: A smart widget that automatically switches between Row (horizontal) and Column (vertical) layouts based on screen width. Perfect for profile headers and toolbars.
• Added AdaptiveContainer: Enables Component-Driven Design. This widget rebuilds its child based on its own width (Parent Constraints) rather than the screen size.

🖥️ Desktop & Breakpoint Enhancements #

• Granular Breakpoints: Added smallDesktop (900px-1200px) and largeDesktop (>1800px) to ResponsiveConfig and ResponsiveGrid. You now have control over 6 distinct screen sizes.
• AppWidthLimiter Logic Upgrade:
  • Scaling Reset: When AppWidthLimiter constrains the app width (e.g., to 1400px), it now injects a new scaling context.
  • Result: Elements inside the limiter scale relative to the limit (1400px), not the huge screen width (e.g., 4000px). This prevents "Gigantic UI" on ultra-wide monitors.

🐛 Fixes & Improvements #

• ResponsiveFlex Overflow: Fixed RenderFlex overflow issues by implementing mainAxisSize: MainAxisSize.min defaults.
• Grid Stability: Improved childAspectRatio logic in ResponsiveGrid to prevent layout breaks on resize.
• Documentation: Updated README with comprehensive examples for the new layout widgets.

🐛 Hotfix #

• Restored API: Fixed missing context.valueByScreen() method that was accidentally removed in 2.0.1.

⚡ Performance Overhaul (Zero Allocation) #

• Zero Allocation Strategy: Completely removed the internal caching layer to eliminate memory allocation overhead. The engine now uses direct O(1) math.
• Inline Optimization: Applied vm:prefer-inline to all core extensions (.w, .h, .sp, etc.) to force the compiler to execute getters directly in the hot path.
• Smart Equality Checks (Quantization): Implemented Integer-based IDs in ResponsiveData. This prevents "phantom rebuilds" caused by microscopic floating-point errors (e.g., 100.0 vs 100.0000001).
• Safety Asserts: Added debug-mode assertions to ensure GlobalResponsive updates only happen during valid frame phases.

📦 New Features: Container Queries #

• Added ScalifyBox: A game-changing widget that allows Local Scaling. Scale UI elements based on their parent container's size, not just the screen size. Perfect for Cards and Grids.
• Added ScalifyFit: Control how content scales inside a ScalifyBox (width, height, contain, cover) to handle dynamic aspect ratios automatically.

🛡️ 4K & Ultra-Wide Protection #

• Smart Dampening Algorithm: Introduced a non-linear scaling logic for screens wider than 1920px (configurable). This prevents UI elements from becoming comically large on TVs or Ultra-wide monitors.
• New Config Options: Added memoryProtectionThreshold and highResScaleFactor to ResponsiveConfig.

🛠️ Maintenance & Docs #

• 100% Documentation: Added comprehensive Dartdoc comments to all public APIs to meet pub.dev scoring requirements.
• Code Formatting: The entire codebase is now strictly formatted according to Dart standards.
• Resize Debouncing: The provider waits for window resize events to settle before recalculating layout, eliminating lag on Desktop/Web.

📦 New Features: Container Queries #

• Added ScalifyBox: A game-changing widget that allows Local Scaling. Scale UI elements based on their parent container's size, not just the screen size. Perfect for Cards and Grids.
• Added ScalifyFit: Control how content scales inside a ScalifyBox (width, height, contain, cover) to handle dynamic aspect ratios automatically.

🛡️ 4K & Ultra-Wide Protection #

• Smart Dampening Algorithm: Introduced a non-linear scaling logic for screens wider than 1920px (configurable). This prevents UI elements from becoming comically large on TVs or Ultra-wide monitors while saving Texture Memory.
• New Config Options: Added memoryProtectionThreshold and highResScaleFactor to ResponsiveConfig.

⚡ Ultimate Performance (Zero-Cost) #

• LRU Caching System: Implemented an internal cache for EdgeInsets (.p) and BorderRadius (.br). This reduces memory allocations by up to 90% during rebuilds.
• Resize Debouncing: The provider now waits for the window resize to settle before recalculating layout (Smart Throttling), eliminating lag on Desktop/Web resizing.
• Optimized Getters: Refactored extension getters to access data in O(1) time without unnecessary context lookups in hot paths.

🛠️ API & DX Improvements #

• Context Shortcuts: Added context.screenType getter for faster checks.
• Grid Stability: Fixed layout overflows in dynamic grids using the new ScalifyFit logic.

🛡️ Critical Fixes & Null Safety #

• Defensive Programming: Implemented robust null checks using MediaQuery.maybeOf to prevent crashes when context is invalid.
• Safe Fallbacks: Added ResponsiveData.identity to provide safe default values (fallback) if the provider is not found or during early app initialization.
• Web/Desktop Stability: Handled edge cases where screen dimensions might report as 0 during the first frame or window resizing.
• Global Safety: GlobalResponsive.data no longer throws exceptions but returns safe defaults with a debug warning.

✨ Improvements & Features #

• Two-Axis Scaling: Introduced scaleWidth (width-driven) and scaleHeight (height-driven) with a smart combined factor for better scaling on ultra-wide or short screens.
• ResponsiveConfig Enhancements:
  • respectTextScaleFactor: When enabled, .fz respects system accessibility text settings.
  • minScale & maxScale: Added clamping bounds to prevent UI elements from becoming too small or excessively large.
  • outerHorizontalPadding: Added breathing room for width-limited layouts.
• Performance: Added debounce mechanism for window-resize events on Desktop/Web to reduce rebuild churn.
• Validation: Added strict validation for list-based padding shortcuts (accepts lengths of 1, 2, or 4 only) with informative error messages.
• AppWidthLimiter: Now supports optional horizontalPadding.

📝 Notes #

• Backwards Compatibility: All public extensions (.w, .h, .fz, .s, etc.) remain fully compatible.
• Recommendation: It is highly recommended to wrap your app with ResponsiveProvider to ensure complete null safety and reactive layout updates.

Added #

• Initial release of flutter_scalify
• Responsive extensions for text size (.fz), spacing (.s), icons (.iz), width (.w), height (.h), radius (.r), and UI elements (.ui)
• Padding shortcuts (.p, .ph, .pv, etc.)
• SizedBox shortcuts (.sbh, .sbw)
• BorderRadius shortcuts (.br, .brt, .brb, .brl, .brr)
• ScalifyProvider widget for easy setup
• ResponsiveHelper class with screen type detection
• AppWidthLimiter widget for limiting app width on large screens
• Support for Watch, Mobile, Tablet, Small Desktop, Desktop, and Large Desktop screen sizes
• Beautiful example app demonstrating all features including a responsive grid that adapts to different screen sizes.