Build1 publisher2 min readPublished
Apple's Pass Designer beta replaces hand-written pass.json for developers on macOS 27
Apple's Pass Designer beta builds Wallet passes from fields and color choices for teams on macOS 27 with an Apple Developer account. Teams without both still write the pass.json by hand or pay for a third-party tool.
The Engineer · Build desk

What happened
- Before export, the app checks that passTypeIdentifier and teamIdentifier match a real certificate, and it marks a missing field in red instead of writing a broken file.
- Apple's Pass Designer page says the preview uses the same renderer as iOS and watchOS, according to a dev.to post that walked through the beta.
- Apple supplies templates for boarding passes, coupons, event tickets, store cards and generic passes, with background, foreground and label colors set separately.
- Semantic tags add structured data that lets Siri suggest an event ticket before the event and lets Maps offer a route to the venue without opening Wallet.
Compiled by The EngineerSomething wrong?How this is made
Why it matters
- capability One person who does not read JSON can now set layout, contrast and Watch fit, so the old handoff between a JSON author and a visual reviewer shrinks to one seat on the developer account.
- cost A wrong identifier now costs a red field in the editor; before, it cost a built pass that failed only when someone opened it on a real iPhone.
- decision Teams paying a third-party tool only to produce pass.json can move design work to Apple's editor without converting files, as long as their designers run macOS 27.
Pass Designer puts a graphical interface over the schema Apple has documented under Wallet Passes for more than a decade [6]. Each pass it produces is still a pass.json compressed with its images into a .pkpass [5]. The two keys that decide whether a pass exports sit near the top of the post's minimal store card [7]:
``` "passTypeIdentifier": "pass.org.programacion.cafeteria", "teamIdentifier": "A1B2C3D4E5", ```
Until now, the first check on a typo in a required key such as passTypeIdentifier was an iPhone failing to open the pass [9]. The app's export check moves that test onto the Mac [8]. I think the certificate in that check is why the download sits behind an Apple Developer account [4]. A validator that compares teamIdentifier with a certificate needs a team that holds one. The other half of the gate is the operating system: the app requires macOS 27 [4] and shipped in beta alongside it [10].
The post frames the gain as the end of a handoff. Designing a pass used to take two people, one assembling the JSON with the right fields and another checking that the colors and logo looked right on screen [11]. Every change now renders at once in two previews, one for iPhone and one for Apple Watch [13]. The Watch screen is much smaller, and a field that reads well on the phone can be clipped on the wrist [13].
The fidelity claim is Apple's, relayed by the post [3]. For it to hold on a customer's phone, the renderer inside a beta Mac app has to match the iOS and watchOS builds that customer runs. A pass designed against one build and opened on another is the first case to test.
Semantic tags are the part of a pass the preview cannot show. In the post's event-ticket example, a semantics block carries eventName, venueName and eventStartDate next to the visible primaryFields [16]. On screen, the ticket looks the same with or without that block [18].
The sample store card hard-codes a single serialNumber, CAFE-00142 [17]. The post does not describe how an exported pass gets from the Mac to a customer's iPhone. According to the post, Pass Designer replaces two routes: writing pass.json directly and paying for a third-party tool [2].
What to watch
- Whether Apple ships Pass Designer outside the beta, or for macOS releases before 27, which decides how many teams can stop hand-writing pass.json.
- Any Apple documentation on how Pass Designer exports plug into a server that issues one pass per customer.
- Whether the preview keeps pace with iOS and watchOS releases after macOS 27 ships, since the same-renderer claim depends on it.