Rabbinatix
Sign inGet started
Store

List, search and page

FreeFlow
@rabbinatix/list-search-and-page by Rabbinatixupdated Oct 13, 2026

A list people can search and scroll: words to search, a page size with a limit, and a cursor for the next page.

Sign up to use it

The search box and "Load more" under a list of products (or orders, users, anything):

  • Client app sends the search words, the page size and the cursor of the page it wants, and gets the items, how many, and whether there is more.
  • Catalogue service refuses a page size outside the limit and a one-letter search, uses the default page size when none is given, and asks the database for one page.
  • Catalogue database answers with the page and the cursor of the next one (empty on the last page).

Tricky step: the cursor is the position of the last item shown, not a page number. With page numbers, an item added while someone scrolls pushes everything along: they see one item twice, or miss one. Searching for nothing lists everything.

Previewlanes are roles; you pick your systems when importing
Not found400Other
Start in Client app. step 1 of 12. key stepOn Search products
Call to another system in Client app. step 2 of 12. key stepCall search products
Start in Catalogue service. step 3 of 12. key stepOn GET /api/v1/products
Return in Catalogue service. step 4 of 12. key stepBad page size → 400
Return in Catalogue service. step 5 of 12. key stepToo short to search → 400
Resource in Catalogue service. step 6 of 12. key stepFind a page of products
Answer in Catalogue database. step 7 of 12. key stepproducts.search
Return in Catalogue service. step 8 of 12. key stepPage → 200
Return in Catalogue service. step 9 of 12. key stepNothing matches → 200, empty
Return in Client app. step 10 of 12. key stepReturn
Return in Client app. step 11 of 12. key stepReturn
Return in Client app. step 12 of 12. key stepReturn
Client app
Web frontend
Catalogue service
Backend service
Catalogue database
Database

Up and down arrows: previous or next step. Home, End: first or last. Enter: select. Shift F10: more actions.

APIs
GET{base}/products· Search products, a page at a time
Catalogue service provides it · Client app calls it
200
items: { id: string, name: string, price: number }[]
nextCursor: string
400
error: string
Data operations
products.searchqueryon Catalogue database(q: string, cursor: string, limit: integer)
Test cases
First page of a search→ First page, more to come
Next page with the cursor→ Last page
Nothing matches→ Nothing matches
Page size too big→ Page size refused
One letter→ Too short to search
No words, no page size: everything, default page→ Everything
Requirements
Pages follow a cursor, so scrolling never shows an item twice or skips one.
A page is never bigger than the limit; with no size, the default is used.
A search needs at least two letters; no words lists everything.
Roles (3)
Client app
Where the list and the search box are · Web frontend or mobile app
Catalogue service
Checks the request and finds a page · Backend service
Catalogue database
Products, with a search index · Database
Settings
Default page size20
Largest page100
Search words parameterq (renamable)
Versions