passbook
A Ruby gem for generating Apple Wallet passes (pkpass files) for iOS 6+.
What is passbook?
Passbook is a Ruby gem that allows developers to generate Apple Wallet passes (pkpass files) for iOS devices. It handles the creation of passes, certificate signing, and integration with web services for push notifications. The gem simplifies the process of building and updating passes according to Apple's specifications.
Ruby developers building applications that need to create or manage Apple Wallet passes, particularly those working with Rails or Sinatra frameworks.
It provides a pure Ruby solution for generating pkpass files with built-in support for certificates, push notifications, and framework integration, reducing the need to manually handle Apple's complex pass requirements.
Overview
Passbook gem let's you create pkpass for passbook iOS 6
Use Cases
Best For
- Adding Apple Wallet pass support to Ruby on Rails applications
- Generating event tickets or boarding passes for iOS users
- Creating digital loyalty cards or coupons for mobile wallets
- Building pass update services with push notifications
- Integrating pass generation into Sinatra-based web apps
- Automating pkpass creation via command line tools
Not Ideal For
- Teams using non-Ruby backends like Node.js or Python
- Projects needing a visual GUI or drag-and-drop pass builder
- Applications requiring real-time pass updates with sub-minute latency
- Organizations with strict compliance needs for automated certificate rotation
Pros & Cons
Pros
Seamlessly works with Rails and Sinatra via configuration generators and Rack middleware, reducing setup time for Ruby-based apps.
Supports both p12 and PEM certificate formats, and allows per-pass signers for different certificates, as shown in the README's configuration examples.
Includes built-in middleware and classes for handling Apple's push service, abstracting the complexity of pass update workflows.
Provides CLI commands like 'pk generate' and 'pk build' for quick pass generation and testing without full app integration.
Cons
Requires manual extraction and management of Apple certificates (WWDC, p12/PEM), which is error-prone and poorly documented in the gem itself.
Push notification support demands custom class implementation with minimal guidance, and the README defers to external articles for key steps.
Admits updates can take up to 15 minutes per device, and handling multiple devices requires separate calls, which may not scale for large user bases.
Frequently Asked Questions
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.