Dependency Status Code Climate

Panther is a lightweight, opinionated architecture for creating API-only Rails applications.

It is heavily inspired by Trailblazer but is much more opinionated and has a gentler learning curve.


Add this line to your application's Gemfile:

ruby gem 'panther'

And then execute:

$ bundle

Or install it yourself as:

$ gem install panther


TODO: Write usage instructions


Bug reports and pull requests are welcome on GitHub at


The gem is available as open source under the terms of the MIT License.


  • [ ] Write API documentation.
  • [ ] Write user guides.
  • [ ] Write tests.
  • [x] Don't include Dry::Types directly into Contract::Base.
  • [x] Only expose existing attributes in Representer::Timestamped.
  • [ ] Use a stable version of ROAR.
  • [ ] Provide a way for operations to inherit callbacks.
  • [ ] Provide a way to configure pagination in the Index operation.
  • [ ] Discover supported operations automatically in Panther::Controller.
  • [ ] Support Kaminari as well as will_paginate in Representer::Sideload.
  • [ ] Allow providing the per_page option in Representer::Sideload.
  • [ ] Allow nesting the include option in Representer::Sideload.