OSS Tanbou

add lightweight offset, keyset, countless, and other pagination strategies to Ruby applications

About these scores

OSS scale score is an unbounded metric that log-compresses and weights Stars, Watchers, Forks, and Contributors. Discovery score is the current OSS scale score minus the score at discovery. Update pace is commits in the last 30 days, growth momentum is the OSS scale score difference within the recent observation window, and OSS health is a 0–100 rating based on available recency, Community Health, and release data.

Stars
4,993
Primary language
Ruby
License
MIT
Repository last updated
Oct 3, 2026
On this page

Overview

Pagy is a plain-Ruby pagination library. Version 43 exposes offset, countish, countless, keyset, keynav, search, calendar, and other paginator styles through a simplified pagy method while providing server-side and client-side navigation helpers plus JSON-oriented metadata.

Features and best fit

Based on official documentation; not hands-on tested · Content checked:

Key features

Choose pagination strategies to match the collection and workload

Version 43 provides offset, countish, countless, keyset, keynav, search, calendar, and other paginator options behind a simplified pagy method.

Sources: [1][2]

Generate navigation helpers and JSON metadata from the Pagy instance

The @pagy instance can render server-side navigation, JavaScript helpers, information tags, and URL/data hashes for both HTML and API-oriented responses.

Sources: [1][2]

Best fit

Fits Ruby applications that need different pagination techniques across workloads

Pagy is useful when one application needs conventional OFFSET pagination alongside keyset pagination for large ordered datasets, countless flows, or search-backend integrations.

Sources: [1]

Before adoption

Treat version 43 as a redesign rather than a routine upgrade

The README describes v43 as a complete redesign of legacy code, usage, and APIs. Existing applications should follow the migration and upgrade guides and review paginator and helper calls.

Sources: [1][4]

Pagy 43.7.0 requires Ruby 3.3 or newer

The 43.7.0 gemspec declares required_ruby_version >= 3.3, so application and CI runtimes need to meet that floor.

Sources: [3][4]

Official sources

  1. [1]Pagy 43.7.0 README(2026-10-04)
  2. [2]Pagy 43.7.0 Quick Start(2026-10-04)
  3. [3]Pagy 43.7.0 gemspec(2026-10-04)
  4. [4]Pagy 43.7.0 release(2026-10-04)
  5. [5]Pagy MIT license(2026-10-04)
Supplemental curator note

Pagy fits Ruby applications that want pagination without tightly coupling to one collection type or front-end framework. Version 43 is a broad API redesign, so upgrades from older Pagy generations should follow the migration and upgrade guides rather than being treated as a routine version bump.

Try it in 3 steps

  1. 1

    Add Pagy 43.7.0 to an evaluation Ruby project

    Use Ruby 3.3 or newer and pin Pagy under Bundler.

    mkdir pagy-demo && cd pagy-demo && bundle init && bundle add pagy --version 43.7.0
  2. 2

    Verify the Pagy CLI version

    Confirm that the 43.7.0 CLI starts correctly.

    bundle exec pagy --version
  3. 3

    Clone the bundled demo and inspect it

    Copy Pagy's bundled Rack demo locally and validate Ruby syntax without starting a server. In a real application, follow the Quick Start to include Pagy::Method and the required paginator/helper.

    bundle exec pagy clone demo && ruby -c demo.ru
Check the official README

Growth

Growth trends · Last 30 days

4,993 Stars

Trend data is still being collected.

Development activity

Last 90 days · weekly

Commits (last 30 days)
21
Open PRs
0

Development activity is still being collected.

Built with

Categories and tags

GitHub data

GitHub dataView detailed GitHub data

GitHub Topics

  • ruby
  • rails
  • sinatra
  • padrino
  • bootstrap
  • bulma
  • searchkick
  • elasticsearch-rails
  • hanami
  • jsonapi
  • meilisearch
  • typesense-rails
Stars
4,993
Forks
443
Watchers
36
Open issues
0
Contributors
148
Owner type
User
Primary language
Ruby
License
MIT
Repository last updated
Oct 3, 2026
Write a related article

Share a guide or use case for this OSS in Markdown. Articles are published after administrator approval.

Report incorrect information

Tell us if any listing information is incorrect or outdated.

After reading this page, do you know what to do next?