performance_list_view 0.0.5

A production-ready Flutter list wrapper with pagination, pull-to-refresh, error states, and image memory optimization.

⚡ PerformanceListView

Stop reinventing the wheel. PerformanceListView is a production-ready, drop-in replacement for Flutter's standard ListView/GridView. It eliminates boilerplate by handling Pagination, Pull-to-Refresh, Error States, and Memory-Optimized Caching right out of the box.

🚀 Why PerformanceListView?

Standard Flutter lists become complex quickly when you add infinite scrolling and remote images. PerformanceListView solves:

• Jank-Free Scrolling: Uses RepaintBoundary to isolate item paints.
• Memory Bloat: PerformanceImage automatically resizes images to their display size in memory.
• Boilerplate: No more manual ScrollController listeners for pagination.
• Robust UX: Built-in "Retry" buttons for errors and "Empty" states for no data.

✨ Key Features

• Auto-Pagination: Simple onEndReached callback.
• Grid Support: Easy switch to PerformanceListView.grid.
• Sliver Ready: Exported as SliverPerformanceListView for complex CustomScrollView layouts.
• Smart Caching: Built-in wrapper for CachedNetworkImage with optimized memory usage.
• Refreshable: Seamless integration with RefreshIndicator.

📦 Installation

Add this to your pubspec.yaml:

dependencies:
  performance_list_view: ^0.0.5

🛠️ Recent Updates (v0.0.5)

• Major Performance Overhaul: Switched to a fully Sliver-based architecture using CustomScrollView for maximum efficiency and flexibility.
• Optimized Rendering: Integrated RepaintBoundary for each list item and added itemExtent/prototypeItem support for $O(1)$ layout calculations.
• Enhanced Memory Management: PerformanceImage now includes memCacheHeight and memCacheWidth to prevent OOM errors.
• Maximum Extensibility: Added customizable builders for all states (Loading, Empty, Error, Bottom Loader) and support for custom headerSlivers and footerSlivers.
• Modern Flutter/Dart: Full compatibility with Flutter 3.44.0+ and Dart 3.12.0+.
• Testing: Added a comprehensive suite of widget tests to ensure reliability.