Note: This project is no longer being maintained.
Passbook is an iOS 6 feature that manages boarding passes, movie tickets, retail coupons, & loyalty cards. Using the PassKit API, developers can register web services to automatically update content on the pass, such as gate changes on a boarding pass, or adding credit to a loyalty card.
Dubai makes it easy to generate .pkpass from a script or the command line, allowing you to rapidly iterate on the design and content of your passes, or generate one-offs on the fly.
Dubai is named for Dubai, UAE, a center of commerce and trade (and as Dave Rupert was all-too-eager to point out, an unfortunate pun on "Do Buy!").
Installation
$ gem install dubai
Usage
require 'dubai'
Dubai::Passbook.certificate, Dubai::Passbook.password = "/path/to/certificate.p12", "..."
# Example.pass is a directory with files "pass.json", "icon.png" & "[email protected]"
File.open("Example.pkpass", 'w') do |f|
f.write Dubai::Passbook::Pass.new("Example.pass").pkpass.string
end
Command Line Interface
Dubai also comes with the pk binary, which provides a convenient way to generate and preview passes
$ pk generate Example.pass -T boarding-pass
Dubai comes with templates for all of the different Passbook layouts:
boarding-passcouponevent-ticketstore-cardgeneric
Build a .pkpass file (which can previewed with a drag-and-drop onto the iOS Simulator):
$ pk build Example.pass -c /path/to/certificate.p12
...or serve them from a webserver (which can be previewed by visiting the address on a device or the simulator):
$ pk serve Example.pass -c /path/to/certificate.p12
$ open http://localhost:4567/pass.pkpass
Specify a -H / --host option to bind the server to a particular host. Binding on 0.0.0.0 will listen for all incoming connections on the local network, such as an iPhone or iPad:
$ pk serve Example.pass -H 0.0.0.0
License
Dubai is available under the MIT license. See the LICENSE file for more info.
4 Jul 19, 2022
790 Dec 9, 2022
1.3k Jan 2, 2023
5 Feb 14, 2022
349 Dec 10, 2022
141 Dec 22, 2022
29 Nov 14, 2022
3 Nov 1, 2021
1 Nov 24, 2021
524 Dec 29, 2022
4 Jun 21, 2022
0 Jun 13, 2022
2.3k Jan 3, 2023
972 Dec 17, 2022
19 May 12, 2022
73 Dec 13, 2022
833 Jan 3, 2023
67 Dec 31, 2022
4 Dec 29, 2022