auto_paginated_list 0.0.2

`AutoPaginatedList` is a Flutter widget that simplifies infinite scrolling and pagination using `Provider` for state management. It automatically fetches more data as the user scrolls, supports custom [...]

AutoPaginatedList is a Flutter widget that simplifies infinite scrolling and pagination with Provider-based state management. It automatically loads more data as the user scrolls, supports custom loading, error, and empty states, and provides flexible configuration options for a seamless experience.

Features

✅ Automatic Pagination – Fetches more data as the user scrolls. ✅ Provider-Based State Management – Efficient and optimized with ChangeNotifier. ✅ Customizable UI – Supports loading, error, and empty state widgets. ✅ Smooth Performance – Scroll handling optimized with a ScrollController. ✅ Flexible Configuration – Customize page size, separators, initial page, and physics. ✅ Easy Integration – Just pass your data-fetching function and item builder!

Usage

To use this package, simply integrate it into your Flutter project and provide a function to fetch paginated data. The package handles infinite scrolling, loading indicators, error handling, and empty states out of the box.

You can customize the appearance using optional widgets for loading, error, and empty states. Additionally, separators can be added between list items.

For a complete implementation, check the /example folder in the repository.

class PaginatedListScreen extends StatelessWidget {
  const PaginatedListScreen({super.key});

  // Simulating an API call
  Future<List<String>> fetchItems(int page) async {
    // page will be automatically incremented.
    await Future.delayed(const Duration(seconds: 2));
    return List.generate(10, (index) => 'Item ${(page - 1) * 10 + index + 1}');
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Paginated ListView')),
      body: PaginatedListView<String>(
        fetchData: fetchItems,
        itemBuilder: (context, item) => ListTile(title: Text(item)),
        itemsPerPage: 10, //  Page size per page
        initialPage: 1, // Initial page
        totalPagesFromApi: 5, // Total pages
        loadingWidget: const Center(child: CircularProgressIndicator()),
        emptyWidget: const Center(child: Text('No items found')),
        errorWidget: const Center(child: Text('Error loading data')),
        separatorBuilder: (context, index) => const Divider(),
      ),
    );
  }
}

Additional information

Contributing 🤝 I welcome contributions! If you’d like to improve this package, feel free contact.

Reporting Issues 🐛 If you encounter a bug or have a feature request, please open an issue on the GitHub Issues page. When reporting an issue, please provide: - A clear description of the problem - Steps to reproduce (if applicable) - Expected vs. actual behavior - Logs or screenshots (if relevant)