Pagination
v0.15.0Range and previous / next, or numbered pages, for long lists.
Pagination simple
Install
npx shadcn add @syncrobotic/pagination Also installs: lucide-react, @syncrobotic/cn, @syncrobotic/button, @syncrobotic/filter-form
Overview
Where you are in a long list, and how to move through it.
When to use
- Tables and lists with more rows than fit.
Use something else
- A short list: show it all.
- Finding one record: Command or a search field.
More examples
States and real uses. Each example is also a Storybook story and a visual regression test.
Pagination pages
Pagination compact
Pagination single page
Pagination empty
Pagination middle
Pagination links
Usage rules
- Say the range (1–10 of 48) so people know how much there is.
- Previous and next disable at the ends. Numbered pages only for long lists people jump around in.
- When the list is a page of its own, use
hrefso each page is a URL: shareable, Back works, no JavaScript needed. - On a phone or in a gallery, prefer LoadMore: pages suit a desktop table, a growing list suits scrolling.
Changelog
- 0.15.02026-11-19The range never wraps; in a container under 36rem the page numbers fold to previous, current and next.
- 0.12.02026-11-18Link mode:
hrefmakes every page a link (?page=3), so it can be shared, Back works and it needs no JavaScript;onNavigateroutes through the app's router.onPageChangeis optional withhref. - 0.8.02026-11-17First release.