#

# Quick Start


# 1. Install

To prevent unexpected breaking changes omit the patch version:

Gemfile
gem 'pagy', '~> 43.0' # Stable version (Pessimistic version constraint)

# 2. Use it in your app

  • Include the pagy method where you are going to use it (usually ApplicationController):

    include Pagy::Method
  • Use it to paginate any collection with any technique:

    @pagy, @records = pagy(:offset, Product.some_scope, **options) # :offset paginator
    @pagy, @records = pagy(:keyset, Product.some_scope, **options) # :keyset paginator
    @pagy, @records = pagy(...)

    See all the available paginators

  • Render navigator tags and other helpers with the @pagy instance methods:

    <%# Render navigation bar helpers with various types and styles %>
    <%== @pagy.series_nav %>
    <%== @pagy.series_nav_js(:bootstrap) %>
    <%== @pagy.input_nav_js(:bulma) %>
    <%== @pagy.info_tag %>

    See all the available @pagy methods

# 3. Configure global options and special features

# Pick a stylesheet or a CSS framework

  • For native pagy helpers you can integrate the Stylesheets (CSS or Tailwind) into your app.
  • For :bootstrap and :bulma styles, no additional CSS file is needed.

# If you use any *_js method...