{"id":16948752,"url":"https://github.com/timoliver/passkit-business-card","last_synced_at":"2025-04-06T21:16:48.313Z","repository":{"id":145130145,"uuid":"88712784","full_name":"TimOliver/PassKit-Business-Card","owner":"TimOliver","description":"A template for iOS Wallet passes that can be used like business cards.","archived":false,"fork":false,"pushed_at":"2020-08-08T08:04:43.000Z","size":7389,"stargazers_count":404,"open_issues_count":2,"forks_count":53,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-03-30T19:11:11.105Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Objective-C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TimOliver.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null},"funding":{"github":"timoliver","custom":"https://tim.dev/paypal"}},"created_at":"2017-04-19T07:08:40.000Z","updated_at":"2025-03-24T11:51:07.000Z","dependencies_parsed_at":null,"dependency_job_id":"f04438e5-832e-40d8-b0c5-e1da31bffc75","html_url":"https://github.com/TimOliver/PassKit-Business-Card","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TimOliver%2FPassKit-Business-Card","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TimOliver%2FPassKit-Business-Card/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TimOliver%2FPassKit-Business-Card/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TimOliver%2FPassKit-Business-Card/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TimOliver","download_url":"https://codeload.github.com/TimOliver/PassKit-Business-Card/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247550693,"owners_count":20956987,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-13T21:52:18.848Z","updated_at":"2025-04-06T21:16:48.265Z","avatar_url":"https://github.com/TimOliver.png","language":"Objective-C","funding_links":["https://github.com/sponsors/timoliver","https://tim.dev/paypal"],"categories":[],"sub_categories":[],"readme":"# PassKit-Business-Card\n\u003e A template that can be used to generate passes for the iOS Wallet app that can be used like business cards.\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://raw.githubusercontent.com/timoliver/PassKit-Business-Card/master/screenshot.jpg\" style=\"margin:0 auto\" /\u003e\n\u003c/p\u003e\n\nA new trend that's been emerging in recent years is taking the pass features of the [Wallet](https://support.apple.com/en-us/HT204003) app, available on every iPhone, and using them in new and interesting ways.\n\nOne novel idea is the concept of having a pass that serves as a virtual business card. Anyone with an iPhone is guaranteed to have the app installed, it's easier than carrying physical cards around, and it usually leaves a lasting impression.\n\nThis repository is a basic template indicating all of the metadata and assets needed to create a business card. It also contains a compiled version of the utility that Apple published that allows pass bundles to be properly signed with a Developer certificate so they'll work on consumer hardware.\n\nI can't take credit for this idea. A major shoutout goes to [Thi Doan](http://twitter.com/thi_dt) for originally sharing his virtual business card with me. :)\n\n# Requirements\n\n* An active, paid Apple Developer subscription.\n* A text editing app.\n* A graphics editing app.\n\n# Generating a Signing Certificate\nBefore the pass will work on any device (Even the iOS Simulator), it is necessary to sign it with a certificate issued by Apple.\n\n1. Go to your [Apple Developer Account](https://developer.apple.com/account/).\n2. Go to 'Certificates, Identifiers \u0026 Profiles' and click on 'Pass Type IDs'.\n3. Create a new Pass Type ID, specifying an appropriate identifier string.\n4. Go to Certificates, click on '+', and select a 'Pass Type ID Certificate'.\n5. Select your previously created Pass Type ID, and follow the steps to generate a certificate and import it into your Mac's security keychain.\n\n# Configuring Your Pass\nAll of the information and configuration settings for a pass are located in the `pass.json` file.\n\nTo align the pass template with the signing certificate generated by Apple, open `pass.json` and:\n\n* For `passTypeIdentifier`, paste in the identifier string you chose in the 'Pass Type IDs' panel.\n* For `teamIdentifier`, go to the [Membership panel](https://developer.apple.com/account/#/membership/) in your Apple Developer account, and copy the code in your 'Team ID' row.\n\n# Building Your Pass\nOnce `pass.json` is configured with your Pass Type ID and Team ID, and you've installed the certificate in your keychain, you can use the `signpass` utility to generate a pass.\n\nOpen Terminal, navigate to this project folder, and then run\n```\n./signpass -p PassKit-Business-Card\n```\n\nIf all goes well, this will generate a `PassKit-Business-Card.pkpass` file in the same folder.\n\n# Testing Your Pass\nOnce a pass has been generated, you can test it in the iOS Simulator. Simply open any of the iPhone device simulators, and drag the `.pkpass` file over the Simulator window. If the pass was set up correctly, it will then automatically display in the Simulator. If it fails, nothing will happen.\n\n# Debugging Your Pass\nIf dragging the `.pkpass` file into the iOS Simulator does nothing, you can open the 'Console' app on your Mac, to view the device logs of the iOS Simulator. Each time you try and import the `.pkpass` file, an error message with the reason why it failed will appear in the log.\n\n# More Information\n* For Apple's documentation on creating passes, check the [Introducing Wallet](https://developer.apple.com/library/content/documentation/UserExperience/Conceptual/PassKit_PG/index.html#//apple_ref/doc/uid/TP40012195-CH1-SW1) page on the Apple Developer Website.\n* For more information on the types of keys allowed in `pass.json`, check the [Top-Level Keys](https://developer.apple.com/library/content/documentation/UserExperience/Reference/PassKit_Bundle/Chapters/TopLevel.html) page on the Apple Developer website.\n* For sample passes, as well as the source code for `signpass`, check out [this sample code download](https://developer.apple.com/services-account/download?path=/iOS/Wallet_Support_Materials/WalletCompanionFiles.zip).\n\n# License\n\nAll of the code in this repository, except for Apple's `signpass` code is released under public domain. No credit is necessary. ![analytics](https://ga-beacon.appspot.com/UA-5643664-16/PassKit-Business-Card/README.md?pixel)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimoliver%2Fpasskit-business-card","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftimoliver%2Fpasskit-business-card","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimoliver%2Fpasskit-business-card/lists"}