Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/ddnexus/pagy

🏆 The Best Pagination Ruby Gem 🥇
https://github.com/ddnexus/pagy
bootstrap bulma elasticsearch-rails foundation materialize padrino rails ruby searchkick semantic-ui sinatra
Last synced: about 2 months ago
JSON representation
🏆 The Best Pagination Ruby Gem 🥇
Host: GitHub
URL: https://github.com/ddnexus/pagy
Owner: ddnexus
License: mit
Created: 2017-12-31T11:48:16.000Z (over 6 years ago)
Default Branch: master
Last Pushed: 2024-04-20T14:33:02.000Z (5 months ago)
Last Synced: 2024-04-21T07:57:58.628Z (5 months ago)
Topics: bootstrap, bulma, elasticsearch-rails, foundation, materialize, padrino, rails, ruby, searchkick, semantic-ui, sinatra
Language: Ruby
Homepage: https://ddnexus.github.io/pagy
Size: 19.6 MB
Stars: 4,458
Watchers: 31
Forks: 392
Open Issues: 13
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE.txt
- Security: .github/SECURITY.md
- Support: .github/SUPPORT.md
Awesome Lists containing this project

awesome-ruby - Pagy - Pagy is the ultimate pagination gem that outperforms the others in each and every benchmark and comparison. More details can be found on [Pagy Wiki](https://ddnexus.github.io/pagy/index). (Pagination)
awesome-luooooob - ddnexus/pagy - 🏆 The Best Pagination Ruby Gem 🥇 (Ruby)
awesome-list - pagy
awesome-hanami - pagy - The ultimate pagination ruby gem. [Integration to hanami](http://katafrakt.me/2018/06/01/integrating-pagy-with-hanami/). (Hanami Gem List / Pagination)
README

        # Pagy

[![Gem Version](https://img.shields.io/gem/v/pagy.svg?label=Pagy&colorA=99004d&colorB=cc0066)](https://rubygems.org/gems/pagy) 

[![Ruby](https://img.shields.io/badge/Ruby-EOL-ruby.svg?colorA=99004d&colorB=cc0066)](https://endoflife.date/ruby) 

[![Ruby Test](https://github.com/ddnexus/pagy/actions/workflows/ruby-test.yml/badge.svg?branch=master)](https://github.com/ddnexus/pagy/actions/workflows/ruby-test.yml) 

[![E2E Test](https://github.com/ddnexus/pagy/actions/workflows/e2e-test.yml/badge.svg?branch=master)](https://github.com/ddnexus/pagy/actions/workflows/e2e-test.yml) 

![Coverage](https://img.shields.io/badge/Coverage-100%25-coverage.svg?colorA=1f7a1f&colorB=2aa22a) 

![Rubocop Status](https://img.shields.io/badge/Rubocop-passing-rubocop.svg?colorA=1f7a1f&colorB=2aa22a) 

[![MIT license](https://img.shields.io/badge/License-MIT-mit.svg?colorA=1f7a1f&colorB=2aa22a)](http://opensource.org/licenses/MIT) 

![Commits](https://img.shields.io/github/commit-activity/y/ddnexus/pagy.svg?label=Commits&colorA=004d99&colorB=0073e6) 

![Downloads](https://img.shields.io/gem/dt/pagy.svg?label=Downloads&colorA=004d99&colorB=0073e6) 

[![Stars](https://shields.io/github/stars/ddnexus/pagy?style=social)](https://github.com/ddnexus/pagy/stargazers)

## 🏆 The Best Pagination Ruby Gem 🥇

---

### ✴ What's new in 9.0+ ✴

- Wicked-fast [Keyset Pagination](https://ddnexus.github.io/pagy/docs/api/keyset/) for big data! It works with `ActiveRecord::Relation` and `Sequel::Dataset` sets.

- More [Playground Apps](https://ddnexus.github.io/pagy/playground/) to showcase, clone and develop pagy APPs without any setup on your side

- Lots of refactorings and optimizations  

- See the [Changelog](https://ddnexus.github.io/pagy/changelog) for possible breaking changes

---

### 🚀 🚀 🚀 🚀 🚀

[](https://ddnexus.github.io/pagination-comparison/gems.html#ips-benchmark) [](https://ddnexus.github.io/pagination-comparison/gems.html#memory-profile) [](https://ddnexus.github.io/pagination-comparison/gems.html#memory-profile) [](https://ddnexus.github.io/pagination-comparison/gems.html#efficiency-ratio)

_Each dot in the visualization above represents the resources that Pagy consumes for one full rendering. The other gems consume

hundreds of times as much for the same rendering._

_The [IPS/Kb ratio](http://ddnexus.github.io/pagination-comparison/gems.html#efficiency-ratio) is calculated out of speed (IPS)

and Memory (Kb): it shows how well each gem uses each Kb of memory it allocates/consumes._

Notice: the above charts refers to the comparison of the basic `pagy v3.0.0` helper with `will_paginate v3.1.7`

and `kaminari v1.1.1`.

While it's not up-to-date, you can expect roughly similar results with the latest versions, maybe a bit less dramatic in

performance due to the multiple features added to pagy since v3 (e.g. customizable and translated aria-labels). However, consider

that the difference become A LOT bigger in favor of pagy if you use `*nav_js` helpers, `Pagy::Countless` or JSON and client side

pagination that are not part of the comparison because missing in the other gems.

See the [Detailed Gems Comparison](http://ddnexus.github.io/pagination-comparison/gems.html) for full details.




## 🤩 It does it all. Better.

- **It works in any environment**

  With Rack frameworks (Rails, Sinatra, Padrino, etc.) or in pure ruby without Rack

- **It works with any collection**

  With any ORM, any DB, any search

  gem, [elasticsearch_rails](https://ddnexus.github.io/pagy/docs/extras/elasticsearch_rails), [meilisearch](https://ddnexus.github.io/pagy/docs/extras/meilisearch), [searchkick](https://ddnexus.github.io/pagy/docs/extras/searchkick), `ransack`,

  and just about any list, even if you cannot count it

- **It supports all kinds of pagination**

  [calendar](https://ddnexus.github.io/pagy/docs/extras/calendar "paginates by dates, rather than numbers"),

  [countless](https://ddnexus.github.io/pagy/docs/extras/countless "skips an extra 'count' query"),

  [geared](https://ddnexus.github.io/pagy/docs/extras/gearbox "varies the fetched items depending on the page number e.g. page 1: x items, but page 2: y items etc."),

  [incremental, auto-incremental, infinite](https://ddnexus.github.io/pagy/docs/extras/pagy),

  [headers](https://ddnexus.github.io/pagy/docs/extras/headers "useful for API pagination"),

  [JSON](https://ddnexus.github.io/pagy/docs/extras/metadata "provides pagination metadata - especially useful with frameworks like Vue, React etc. and you want to render your own pagination links"),

  [Keyset Pagination](https://ddnexus.github.io/pagy/docs/extras/keyset/ "Useful with large data sets, where performance becomes a concern")

- **It supports the most popular CSS Frameworks and APIs** like [bootstrap](https://ddnexus.github.io/pagy/docs/extras/bootstrap),

  [bulma](https://ddnexus.github.io/pagy/docs/extras/bulma),

  [tailwind](https://ddnexus.github.io/pagy/docs/extras/tailwind),

  [JSON:API](https://ddnexus.github.io/pagy/docs/extras/jsonapi/)

- **It supports faster client-side rendering**

  With classic or innovative UI components (see [Javascript Components](https://ddnexus.github.io/pagy/docs/api/javascript/)) or

  by

  serving [JSON](https://ddnexus.github.io/pagy/docs/extras/metadata) to your favorite Javascript framework

- **It has 100% of test coverage** for Ruby, HTML and Javascript E2E (

  see [Pagy Workflows CI](https://github.com/ddnexus/pagy/actions))

## 😎 It's easy to use and customize

Code for basic pagination...

```rb

# Include it in the controllers (e.g. application_controller.rb)

include Pagy::Backend

# Include it in the helpers (e.g. application_helper.rb)

include Pagy::Frontend

# Wrap your collections with pagy in your actions

@pagy, @records = pagy(Product.all)

```

Optionally set your defaults in the pagy initializer:

```rb

# Optionally override some pagy default with your own in the pagy initializer

Pagy::DEFAULT[:limit] = 10 # items per page

Pagy::DEFAULT[:size]  = 9  # nav bar links

# Better user experience handled automatically

require 'pagy/extras/overflow'

Pagy::DEFAULT[:overflow] = :last_page

```

```erb

<%# Render a view helper in your views (skipping nav links for empty pages) %>

<%== pagy_nav(@pagy) if @pagy.pages > 1 %>

```

Or, choose from the following view helpers:

| View Helper Name                                                                                                                                                                                                                          | Preview (Bootstrap Style shown)                                        |

|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------|

| [`pagy_nav(@pagy)`](https://ddnexus.github.io/pagy/docs/api/frontend)                                                                                                                                                                     | ![`pagy_nav`](/docs/assets/images/bootstrap_nav.png)                   |

| [`pagy_nav_js(@pagy)`](https://ddnexus.github.io/pagy/docs/api/javascript/)                                                                                                                                                               | ![`pagy_nav_js`](/docs/assets/images/bootstrap_nav_js.png)             |

| [`pagy_info(@pagy)`](https://ddnexus.github.io/pagy/docs/api/frontend)                                                                                                                                                                    | ![`pagy_info`](/docs/assets/images/pagy_info.png)                      |

| [`pagy_combo_nav_js(@pagy)`](https://ddnexus.github.io/pagy/docs/api/javascript/)                                                                                                                                                         | ![`pagy_combo_nav_js`](/docs/assets/images/bootstrap_combo_nav_js.png) |

| [`pagy_limit_selector_js`](https://ddnexus.github.io/pagy/docs/api/javascript/)                                                                                                                                                           | ![`pagy_limit_selector_js`](/docs/assets/images/limit_selector_js.png) |

| [`pagy_nav(@calendar[:year])`](https://ddnexus.github.io/pagy/docs/extras/calendar/)
[`pagy_nav(@calendar[:month])`](https://ddnexus.github.io/pagy/docs/extras/calendar/)
 (other units: `:quarter`, `:week`, `:day` and custom) | ![calendar extra](/docs/assets/images/calendar-app.png)                |

_(See the [Quick Start](https://ddnexus.github.io/pagy/quick-start))_

Customization for CSS frameworks...

```rb

# Require a CSS framework extra in the pagy initializer (e.g. bootstrap)

require 'pagy/extras/bootstrap'

```

```erb

<%# Use it in your views %>

<%== pagy_bootstrap_nav(@pagy) %>

```

_(See all the [CSS Framework Extras](https://ddnexus.github.io/pagy/categories/frontend/))_

Customization for special collections...

```rb

# Require some special backend extra in the pagy initializer (e.g. elasticsearch_rails)

require 'pagy/extras/elasticsearch_rails'

# Extend your models (e.g. application_record.rb)

extend Pagy::ElasticsearchRails

# Use it in your actions

response         = Article.pagy_search(params[:q])

@pagy, @response = pagy_elasticsearch_rails(response)

```

_(See all the [Search Extras](https://ddnexus.github.io/pagy/categories/search/))_

Customization for client-side|JSON rendering...

```ruby

# Require the metadata extra in the pagy initializer

require 'pagy/extras/metadata'

# Use it in your actions

pagy, records = pagy(Product.all)

render json: { data: records,

               pagy: pagy_metadata(pagy) }

```

_(See all the [Backend Tools](https://ddnexus.github.io/pagy/categories/backend/))_

Customization for headers pagination for APIs...

```ruby

# Require the headers extra in the pagy initializer

require 'pagy/extras/headers'

# Use it in your actions

pagy, records = pagy(Product.all)

pagy_headers_merge(pagy)

render json: records

```

_(See all the [Backend Tools](https://ddnexus.github.io/pagy/categories/backend/))_

Customization for JSON:API pagination...

```ruby

# Require the jsonapi extra in the pagy initializer

require 'pagy/extras/jsonapi'

# Use it in your actions

pagy, records = pagy(Product.all)

render json: { data:  records,

               links: pagy_jsonapi_links(pagy) }

# besides the query params will be nested. E.g.: ?page[number]=2&page[size]=100

```

_(See all the [Backend Tools](https://ddnexus.github.io/pagy/categories/backend/))_


 

**More customization with** [Extras](https://ddnexus.github.io/pagy/categories/extra/) that add special options and manage different components, behaviors, Frontend or Backend environments... usually by just

requiring them (and optionally overriding some default).

See also the [How To Page](https://ddnexus.github.io/pagy/docs/how-to)

## 🤓 It's well documented and supported

### Documentation

- [Migrate from WillPaginate and Kaminari](https://ddnexus.github.io/pagy/docs/migration-guide) (practical guide)

- [Quick Start](https://ddnexus.github.io/pagy/quick-start)

- [Documentation](https://ddnexus.github.io/pagy)

- [How To (quick recipes)](https://ddnexus.github.io/pagy/docs/how-to/)

- [Changelog](https://ddnexus.github.io/pagy/changelog)

- [Deprecations](https://ddnexus.github.io/pagy/changelog#deprecations)

- [How Pagy's Docs work?](https://github.com/ddnexus/pagy/blob/master/docs/README.md)

### Support

- [Discussions](https://github.com/ddnexus/pagy/discussions/categories/q-a)

- [Issues](https://github.com/ddnexus/pagy/issues)

### Posts and tutorials

- [Migrate from WillPaginate and Kaminari](https://ddnexus.github.io/pagy/docs/migration-guide) (practical guide)

- [Detailed Gems Comparison](https://ddnexus.github.io/pagination-comparison/gems.html) (charts and analysis)

- [Benchmarks and Memory Profiles Source](http://github.com/ddnexus/pagination-comparison) (Rails app repository)

- [Faster Pagination with Pagy](https://viblo.asia/p/faster-pagination-with-pagy-Eb85ok9W52G) introductory tutorial by Sirajus

  Salekin

- [Pagination with Pagy](https://www.imaginarycloud.com/blog/paginating-ruby-on-rails-apps-with-pagy) by Tiago Franco

- [Quick guide for Pagy with Sinatra and Sequel](https://medium.com/@vfreefly/how-to-use-pagy-with-sequel-and-sinatra-157dfec1c417)

  by Victor Afanasev

- [Integrating Pagy with Hanami](http://katafrakt.me/2018/06/01/integrating-pagy-with-hanami/) by Paweł Świątkowski

- [Stateful Tabs with Pagy](https://www.imaginarycloud.com/blog/how-to-paginate-ruby-on-rails-apps-with-pagy) by Chris Seelus

- [Endless Scroll / Infinite Loading with Turbo Streams & Stimulus](https://www.stefanwienert.de/blog/2021/04/17/endless-scroll-with-turbo-streams/)

  by Stefan Wienert.

- [Build Load More Pagination with Pagy and Rails Hotwire](https://dev.to/maful/build-load-more-pagination-with-pagy-and-rails-hotwire-2ndb) [by Maful](https://dev.to/maful). (

  This tutorial shows how you can turbo_stream with GET requests).

- [Pagination with Hotwire](https://www.beflagrant.com/blog/pagination-with-hotwire) by Jonathan Greenberg

- [Pagination and infinite scrolling with Rails and the Hotwire stack](https://www.colby.so/posts/pagination-and-infinite-scrolling-with-hotwire)

  by David Colby

- [Building a dynamic data grid with search and filters using rails, hotwire and ransack](https://bhserna.com/building-data-grid-with-search-rails-hotwire-ransack.html)

  by Benito Serna.

- [Pagination for Beginners: What is it? Why bother?](https://benkoshy.github.io/2021/11/03/pagination-basics.html) by Ben Koshy.

- [Handling Pagination When POSTing Complex Search Forms](https://benkoshy.github.io/2019/10/09/paginating-search-results-with-a-post-request.html)

  by Ben Koshy.

- [How to Override pagy methods only in specific circumstances](https://benkoshy.github.io/2020/02/01/overriding-pagy-methods.html)

  by Ben Koshy.

- [How to make your pagination links sticky + bounce at the bottom of your page](https://benkoshy.github.io/2020/09/15/sticky-menu.html)

  by Ben Koshy.

- [日本語の投稿](https://qiita.com/search?q=pagy)

- [한국어 튜토리얼](https://kbs4674.tistory.com/72)

### Screencasts

[](https://www.youtube.com/watch?v=1tsWL4EjhMo) [](https://www.youtube.com/watch?v=ScxUqW29F7E) [](https://www.youtube.com/watch?v=A9q6YwhLCyI) [](https://www.youtube.com/watch?v=Qoq6HZ8gdDE) [](https://www.youtube.com/watch?v=EDyZIB8FU-g) [](https://www.youtube.com/watch?v=K4fob588tfM) [](https://www.youtube.com/watch?v=1sNpvTMrxl4) [](https://www.youtube.com/watch?v=0RtYhDIKmBY) [](https://www.youtube.com/watch?v=aILtxj_LVuA) [](https://www.youtube.com/watch?v=ArBUAxEA6vM) [](https://www.youtube.com/watch?v=4nrmf5KfD8Y) [](https://www.youtube.com/watch?v=HURqvNJF4T0) [](https://www.youtube.com/watch?v=_j3gtKf5rRs) [](https://www.youtube.com/watch?v=zni3nMA5_AY)




## Top 💯 Contributors

[](https://github.com/ddnexus/pagy/commits?author=ddnexus)[](https://github.com/ddnexus/pagy/commits?author=benkoshy)[](https://github.com/ddnexus/pagy/commits?author=grosser)[](https://github.com/ddnexus/pagy/commits?author=Earlopain)[](https://github.com/ddnexus/pagy/commits?author=workgena)[](https://github.com/ddnexus/pagy/commits?author=espen)[](https://github.com/ddnexus/pagy/commits?author=enzinia)[](https://github.com/ddnexus/pagy/commits?author=sunny)[](https://github.com/ddnexus/pagy/commits?author=molfar)[](https://github.com/ddnexus/pagy/commits?author=bquorning)[](https://github.com/ddnexus/pagy/commits?author=djpremier)[](https://github.com/ddnexus/pagy/commits?author=747)[](https://github.com/ddnexus/pagy/commits?author=tersor)[](https://github.com/ddnexus/pagy/commits?author=thomasklemm)[](https://github.com/ddnexus/pagy/commits?author=gamafranco)[](https://github.com/ddnexus/pagy/commits?author=tiagotex)[](https://github.com/ddnexus/pagy/commits?author=wimdavies)[](https://github.com/ddnexus/pagy/commits?author=renshuki)[](https://github.com/ddnexus/pagy/commits?author=berniechiu)[](https://github.com/ddnexus/pagy/commits?author=ashmaroli)[](https://github.com/ddnexus/pagy/commits?author=cseelus)[](https://github.com/ddnexus/pagy/commits?author=sabljak)[](https://github.com/ddnexus/pagy/commits?author=petergoldstein)[](https://github.com/ddnexus/pagy/commits?author=rainerborene)[](https://github.com/ddnexus/pagy/commits?author=rbngzlv)[](https://github.com/ddnexus/pagy/commits?author=simonneutert)[](https://github.com/ddnexus/pagy/commits?author=sliminas)[](https://github.com/ddnexus/pagy/commits?author=serghost)[](https://github.com/ddnexus/pagy/commits?author=Tolchi)[](https://github.com/ddnexus/pagy/commits?author=rogermarlow)[](https://github.com/ddnexus/pagy/commits?author=yenshirak)[](https://github.com/ddnexus/pagy/commits?author=rafaelmontas)[](https://github.com/ddnexus/pagy/commits?author=rafaeelaudibert)[](https://github.com/ddnexus/pagy/commits?author=pedrocarmona)[](https://github.com/ddnexus/pagy/commits?author=olleolleolle)[](https://github.com/ddnexus/pagy/commits?author=okuramasafumi)[](https://github.com/ddnexus/pagy/commits?author=WilliamHorel)[](https://github.com/ddnexus/pagy/commits?author=woller)[](https://github.com/ddnexus/pagy/commits?author=sk8higher)[](https://github.com/ddnexus/pagy/commits?author=muhammadnawzad)[](https://github.com/ddnexus/pagy/commits?author=ronald)[](https://github.com/ddnexus/pagy/commits?author=achmiral)[](https://github.com/ddnexus/pagy/commits?author=mauro-ni)[](https://github.com/ddnexus/pagy/commits?author=borama)[](https://github.com/ddnexus/pagy/commits?author=creativetags)[](https://github.com/ddnexus/pagy/commits?author=mcary)[](https://github.com/ddnexus/pagy/commits?author=marckohlbrugge)[](https://github.com/ddnexus/pagy/commits?author=tulak)[](https://github.com/ddnexus/pagy/commits?author=artplan1)[](https://github.com/ddnexus/pagy/commits?author=AngelGuerra)[](https://github.com/ddnexus/pagy/commits?author=tr4b4nt)[](https://github.com/ddnexus/pagy/commits?author=tiejianluo)[](https://github.com/ddnexus/pagy/commits?author=szTheory)[](https://github.com/ddnexus/pagy/commits?author=smoothdvd)[](https://github.com/ddnexus/pagy/commits?author=rhodes-david)[](https://github.com/ddnexus/pagy/commits?author=radinreth)[](https://github.com/ddnexus/pagy/commits?author=okliv)[](https://github.com/ddnexus/pagy/commits?author=nedimdz)[](https://github.com/ddnexus/pagy/commits?author=msdundar)[](https://github.com/ddnexus/pagy/commits?author=m-abdurrehman)[](https://github.com/ddnexus/pagy/commits?author=dwieringa)[](https://github.com/ddnexus/pagy/commits?author=jyuvaraj03)[](https://github.com/ddnexus/pagy/commits?author=YutoYasunaga)[](https://github.com/ddnexus/pagy/commits?author=iamyujinwon)[](https://github.com/ddnexus/pagy/commits?author=yhk1038)[](https://github.com/ddnexus/pagy/commits?author=ya-s-u)[](https://github.com/ddnexus/pagy/commits?author=yshmarov)[](https://github.com/ddnexus/pagy/commits?author=thattimc)[](https://github.com/ddnexus/pagy/commits?author=thomaschauffour)[](https://github.com/ddnexus/pagy/commits?author=snkashis)[](https://github.com/ddnexus/pagy/commits?author=Federico-G)[](https://github.com/ddnexus/pagy/commits?author=egimenos)[](https://github.com/ddnexus/pagy/commits?author=elliotlarson)[](https://github.com/ddnexus/pagy/commits?author=hungdiep97)[](https://github.com/ddnexus/pagy/commits?author=davidwessman)[](https://github.com/ddnexus/pagy/commits?author=david-a-wheeler)[](https://github.com/ddnexus/pagy/commits?author=daniel-rikowski)[](https://github.com/ddnexus/pagy/commits?author=connie-feng)[](https://github.com/ddnexus/pagy/commits?author=MrMoins)[](https://github.com/ddnexus/pagy/commits?author=excid3)[](https://github.com/ddnexus/pagy/commits?author=cellvinchung)[](https://github.com/ddnexus/pagy/commits?author=brunoocasali)[](https://github.com/ddnexus/pagy/commits?author=BrandonKlotz)[](https://github.com/ddnexus/pagy/commits?author=Atul9)[](https://github.com/ddnexus/pagy/commits?author=amenon)[](https://github.com/ddnexus/pagy/commits?author=artinboghosian)[](https://github.com/ddnexus/pagy/commits?author=antonzaharia)[](https://github.com/ddnexus/pagy/commits?author=PyrinAndrii)[](https://github.com/ddnexus/pagy/commits?author=andrew)[](https://github.com/ddnexus/pagy/commits?author=AliOsm)[](https://github.com/ddnexus/pagy/commits?author=AbelToy)[](https://github.com/ddnexus/pagy/commits?author=fluser)[](https://github.com/ddnexus/pagy/commits?author=maful)[](https://github.com/ddnexus/pagy/commits?author=loed-idzinga)[](https://github.com/ddnexus/pagy/commits?author=epeirce)[](https://github.com/ddnexus/pagy/commits?author=kobusjoubert)[](https://github.com/ddnexus/pagy/commits?author=KevinColemanInc)[](https://github.com/ddnexus/pagy/commits?author=neontuna)[](https://github.com/ddnexus/pagy/commits?author=xuanxu)[](https://github.com/ddnexus/pagy/commits?author=jpgarritano)




## 👏 Credits

Many thanks to:

- [Ben Koshy](https://github.com/benkoshy) for his contributions to the documentation, user support and interaction with external

  frameworks

- [GoRails](https://gorails.com) for the great [Pagy Screencast](https://gorails.com/episodes/pagination-with-pagy-gem?autoplay=1)

  and their top notch [Rails Episodes](https://gorails.com/episodes)

- [Imaginary Cloud](https://www.imaginarycloud.com) for continually publishing high-interest articles and helping to share Pagy

  when it just started

- [JetBrains](http://www.jetbrains.com?from=https%3A%2F%2Fgithub.com%2Fddnexus%2Fpagy) for their free OpenSource license

  project

- [The Stargazers](https://github.com/ddnexus/pagy/stargazers) for showing their support

## 📦 Repository Info

How to contribute

See [Contributing](https://github.com/ddnexus/pagy/blob/master/.github/CONTRIBUTING.md)

Versioning

- Pagy follows the [Semantic Versioning 2.0.0](https://semver.org/). Please, check

  the [Changelog](https://ddnexus.github.io/pagy/changelog) for breaking changes introduced by mayor versions.

  Using [pessimistic version constraint](https://guides.rubygems.org/patterns/#pessimistic-version-constraint) in your Gemfile

  will ensure smooth upgrades.

Branches

- The `master` branch is the latest rubygem-published release. It also contains docs and comment changes that don't affect the

  published code. It is never force-pushed.

- The `dev` branch is the development branch with the new code that will be merged in the next release. It could be force-pushed.

- Expect any other branch to be internal, experimental, force-pushed, rebased and/or deleted even without merging.




## 💞 Related Projects

[Search rubygems.org](https://rubygems.org/search?query=pagy)

## 📃 License

[MIT](https://opensource.org/licenses/MIT)