SmartPagination 1.0.0

📦 SmartPagination

🚀 A unified pagination engine for .NET APIs (Offset, Cursor, Smart Auto Selection)

SmartPagination is a lightweight, production-ready library that simplifies pagination across your .NET applications using a single, consistent API.

✨ Features

📄 Offset Pagination (page-based)

⚡ Cursor Pagination (high-performance for large datasets)

🧠 Smart Auto Pagination (SmartPaginateAsync)

🔌 Plug & Play with IQueryable<T>

⚙️ Works seamlessly with EF Core

🧩 Clean and minimal API

🚫 No Dynamic LINQ dependency

📦 Installation

dotnet add package SmartPagination

🚀 Quick Start

Basic Usage (Recommended)

var result = await db.Users

.OrderBy(x ⇒ x.Id)

.SmartPaginateAsync(new PaginationRequest

{

PageSize = 10

});

Offset Pagination

var result = await db.Users

.OrderBy(x ⇒ x.Id)

.SmartPaginateAsync(new PaginationRequest

{

PageNumber = 1,

PageSize = 10

});

Cursor Pagination

var result = await db.Users

.OrderBy(x ⇒ x.Id)

.SmartPaginateAsync(new PaginationRequest

{

Cursor = "25",

PageSize = 10

});

🧠 How Smart Pagination Works

SmartPagination automatically selects the best strategy:

Condition Strategy

PageNumber provided Offset

Cursor provided Cursor

No OrderBy Cursor (safe fallback)

Default Offset

📊 Response Model

public class PagedResult<T>

{

public List<T> Items { get; set; }

public int? PageNumber { get; set; }

public string? NextCursor { get; set; }

public bool HasNextPage { get; set; }

}

⚙️ Pagination Request

public class PaginationRequest

{

public int PageSize { get; set; } = 10;

public int? PageNumber { get; set; }

public string? Cursor { get; set; }

public PaginationType Type { get; set; }

}

🧪 Example: ASP.NET Core API

[HttpGet]

public async Task<IActionResult> GetUsers(int page = 1)

{

var result = await _db.Users

.OrderBy(x ⇒ x.Id)

.SmartPaginateAsync(new PaginationRequest

{

PageNumber = page,

PageSize = 10

});

return Ok(result);

}

⚡ Supported Strategies

📄 Offset Pagination

Best for:

Admin dashboards

Reports

Small datasets

⚡ Cursor Pagination

Best for:

Infinite scroll

Activity feeds

Large datasets

🧠 Smart Pagination (Recommended)

Best for:

APIs with mixed usage

Unknown scale requirements

Automatic performance optimization

🏗️ Requirements

.NET 6 / .NET 7 / .NET 8 / .NET 9

Works with IQueryable<T>

EF Core (optional but recommended)

🔥 Why SmartPagination?

❌ Without it

Rewriting pagination logic every project

Poor performance with large datasets

Inconsistent API behavior

✅ With it

One consistent pagination API

Automatic strategy selection

Better scalability

Cleaner codebase

📌 Roadmap

Seek Pagination (multi-column cursor)

Fluent API (.Paginate().WithCursor())

Performance benchmarking

Caching support

Diagnostics / logging

🤝 Contributing

Contributions are welcome!

Focus areas:

Performance improvements

EF Core optimizations

Developer experience

📄 License

MIT License

⭐ Support

If this package helps you, consider giving it a star ⭐ on GitHub.

🚀 Final Note

Pagination should be solved once — not in every project.

SmartPagination helps you do exactly that.