Getting Started
Installation
go get github.com/ishinvin/pageable
Requires Go 1.21+ (uses generics).
Import
import "github.com/ishinvin/pageable"
Choose Your Pagination Style
| Style | Best For | Trade-offs |
|---|
| Offset-based |
Admin panels, dashboards, "jump to page N" |
Requires COUNT query; inconsistent on live data |
| Cursor-based |
Feeds, infinite scroll, real-time data |
No page jumping; more efficient at scale |
Defaults
| Constant | Value | Description |
|---|
DefaultPage | 1 | Default page number (1-indexed) |
DefaultSize | 10 | Default items per page |
MaxSize | 1000 | Maximum allowed page size |
DefaultCursorSize | 10 | Default cursor page size |
MaxCursorSize | 1000 | Maximum cursor page size |