> ## Content Index
> Fetch the complete content index at: https://thibaultmilan.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# Covid19-Passbook: your EU COVID certificate in Apple Wallet
- URL: https://thibaultmilan.com/projects/covid19-passbook/
- Published: 2026-11-16T22:21:00.000Z
- Updated: 2026-11-16T22:21:57.000Z
- Description: A web app that turned EU Digital COVID Certificates into Apple Wallet passes, without sending personal data anywhere. 45,000+ passes, 28 languages, no ads, no tracking. Running from 2021 to 2026, now closed.
- Author: Thibault Milan
- Tags: project, #nav, Privacy, open source, covid-19

In June 2021, the EU started issuing digital COVID certificates. Mine came by mail, printed in grayscale, with a QR code and no app to keep it in. So I built a web page that turns that QR code into a card for Apple Wallet, without ever sending your personal data anywhere.

It ran from June 2021 to November 2026, generated more than 45,000 passes, and spoke 28 languages. It's now closed, and [the site](https://covid19passbook.netlify.app/?ref=thibaultmilan.com) shows a farewell page.

#### The project in numbers

- **45k+**passes generated
- **18k+**visitors from one Irish Independent article
- **28**languages, translated by volunteers
- **18**code contributors
- **127**GitHub stars, 22 forks
- **0**personal data stored on a server
- **3rd**in Netlify's yearly contest of most useful sites
- **<€1**per month of AWS Lambda

Pass count is an estimate: the project never tracked its users, on purpose.

## What it did

1. Open the page in Safari, on your phone.
2. Point your camera at the QR code of your EU certificate (vaccination, test or recovery), or import a screenshot.
3. Check the preview of your information.
4. Tap the button. The card lands in Wallet, next to your boarding passes. It also works on Apple Watch, and on Android with any app that reads `.pkpass` files.

No install, no account, no store. A web page you use once and forget.

## How it works

Apple requires every Wallet pass to be signed with a private key from an Apple developer account. That key can't be shipped to a browser. The usual answer is a server that receives your data, builds the pass and sends it back.

I didn't want anyone's health data on a server, not even for a second. So the work is split in a very uneven way:

Covid19-Passbook architecture Everything happens in the browser on the phone. Only a manifest of SHA-1 hashes is sent to an AWS Lambda, which signs it in memory and returns the signature. YOUR PHONE · in the browser Personal data never leaves this box 1\. Scan the QR codecamera or imported picture · qr-scanner 2\. Decode the EU certificatebase45, CBOR, COSE · dcc-sdk + EU value sets 3\. Build the passpass.json, images, QR code, 28 languages 4\. Hash every file into a manifestmanifest.json = SHA-1 hashes, no readable data 5\. Zip the .pkpassfiles + manifest + signature · JSZip 6\. Preview, then add to Walletor any .pkpass app on Android AWS API Gateway + Lambda (Node.js) Sign the manifest Apple Pass Type ID cert in memory, nothing stored No database. No logs of content. < €1 per month. → only the hashes go out ← the signature comes back NETLIFY Static PWA, built with Parcel from the GitHub repo No cookies, no analytics, no tracking 

Apple requires every pass to be signed. The private key can't live on the phone, so the phone sends a manifest of SHA-1 hashes, not the data itself.

- **The phone does everything that touches personal data.** It reads the QR code, decodes the certificate (base45, CBOR and COSE, using the EU value sets for vaccines and tests), builds the pass, and computes a `manifest.json`: one SHA-1 hash per file.
- **The server only sees hashes.** A small AWS Lambda receives the manifest, signs it in memory with the Pass Type ID certificate and returns the signature. No database, no stored content. It cost less than a euro a month.
- **The phone finishes the job.** It zips the files, the manifest and the signature into a `.pkpass` and hands it to Wallet.

The site itself is a static PWA built with Parcel and served by Netlify. No cookies, no analytics, no trackers.

## The rules I gave myself

### Store as little as possible

The safest personal data is the data you never receive. Every architecture choice came from that one rule. It also made the privacy page short: there's nothing to declare.

I could have saved myself weeks by plugging into one of the many existing pass generators. They all work the same way: you send them the content, they send you a pass. Here, the content is the QR code, and the QR code holds everything in clear: full name, date of birth, vaccines, test results. Sending that to a third party wasn't an option.

Same reason there was never a Google Wallet button. Google Wallet passes are created on Google's servers, so every field of the certificate would have gone to Google. Android users got the `.pkpass` file instead, readable locally by apps like PassAndroid or Stocard.

### Don't monetize it

No ads, no premium tier, no data to sell. A [Buy Me a Coffee](https://buymeacoffee.com/thibault?ref=thibaultmilan.com) link paid for the Apple developer account, AWS and Netlify, with 10% going to LGBT non-profits. Every euro was in a public transparency report.

#### Where the coffees went

From the public transparency report. 60.5 coffees, every euro accounted for.

Donations€228.34

---

Apple developer€177.55

AWS€19.78

LGBT non-profits€18.32

Netlify€7.60

---

Left in the jar€5.09

### Be useful, then get out of the way

The goal was never to grow a product. It was to fix a small, annoying problem for as many people as possible, for as long as it existed. When Apple added EU certificates to Wallet in iOS 15.4, the project had done its job.

### Open by default

The code is on GitHub. People could check what the app did instead of trusting what I said. That openness brought translators, contributors and, later, a white-label version for Doctoranytime, a health booking platform that offered it to its own patients.

## Stack

- **Front-end:** HTML, JavaScript, Sass, Semantic UI, built with Parcel
- **QR and certificate:** nimiq qr-scanner, Path Check dcc-sdk, EU eHealth Network value sets
- **Pass generation:** JSZip, qrcode.js, Handlebars
- **Signing:** AWS Lambda and API Gateway, deployed with the Serverless Framework
- **Hosting:** Netlify (sponsored account), with a Netlify Function that turned in-app bug reports into GitHub issues
- **Translations:** Crowdin, 28 languages
- **Testing:** BrowserStack, on more iPhones than I'll ever own

## The other COVID-19 projects

Covid19-Passbook was the last of a small series. Between 2020 and 2021, every new rule created a small, very concrete problem, and I kept building small, very concrete answers.

#### A small COVID-19 toolbox

Four answers to four problems, 2020 to 2021.

March 2020**COVID-19 Venue Map**

Which shops are open, which ones deliver. Crowdsourced, started in Dudelange.

Glide + Google Sheets

2020**Digital menu and ordering**

QR codes on tables, menus on phones, orders without touching paper.

for small businesses

March 2021**Customer Registry**

Contact tracing for venues, built live on Twitch in about an hour, given away for free.

#nocode Thursday

June 2021**Covid19-Passbook**

Your EU certificate in Apple Wallet. Personal data never leaves the phone.

45k+ passes

- **COVID-19 Venue Map (March 2020).** During the first lockdown, nobody knew which shops were open. I built a crowdsourced map with Glide and a Google Sheet: open places, restrictions, delivery-only restaurants. People could add a shop or report an error. [Read the original post](https://buymeacoffee.com/thibault/covid-19-app-luxembourg?ref=thibaultmilan.com).
- **Digital menu and ordering (2020).** QR codes on tables, menus on phones, orders without paper, for small businesses trying to stay open. Gathered on [covidluxembourg.app](https://covidluxembourg.app/?ref=thibaultmilan.com).
- **Customer Registry (March 2021).** Some countries required venues to keep a register of customers. Paper sheets on a counter are a terrible idea during a pandemic. I built a QR code contact tracing form live during a [#nocode Thursday stream](https://thibaultmilan.com/talks/nocode-thursday-simple-contact-tracing/), designed to delete the data automatically after 21 days, then [gave it away for free](https://thibaultmilan.com/covid-19-customer-registry/).

Same pattern every time: a real problem, the simplest tool that works, as little data as possible, and no business model.

## Credits

This was never a one-person project.

- [Alain Vagner](https://github.com/biou?ref=thibaultmilan.com) built the signing service with me.
- [Guillaume Rischard](https://www.linkedin.com/in/guillaume-rischard-4522505/?ref=thibaultmilan.com) and [Alain Rouen](https://www.linkedin.com/in/alainrouen/?ref=thibaultmilan.com) gave advice when it mattered.
- [Laurence Vagner](https://redisdead.net/?ref=thibaultmilan.com) redesigned it, [Geoffrey Crofte](https://geoffrey.crofte.fr/?ref=thibaultmilan.com) made it accessible.
- 18 code contributors on GitHub, and the volunteers who translated it on Crowdin.
- [Baptiste Lilles](https://www.linkedin.com/in/lilles-b/?ref=thibaultmilan.com) at Doctoranytime, for the white-label.
- Netlify and BrowserStack, for the free accounts.
- The press: the Irish Independent, Silicon Luxembourg, data.public.lu and others. The full press review is on [the farewell page](https://covid19passbook.netlify.app/?ref=thibaultmilan.com).

## The fine print

The project is closed. The site shows a farewell page, the AWS stack is deleted, and the GitHub repositories are archived. Passes already in people's Wallets were never stored on any server and are not affected.

The code stays public on GitHub: [the generator](https://github.com/clawfire/covid19-passbook-generator?ref=thibaultmilan.com) and [the signing service](https://github.com/clawfire/covid19-passbook-signature?ref=thibaultmilan.com).

For the full story, what worked and what didn't, read the post-mortem: <https://thibaultmilan.com/covid19-passbook-post-mortem/>

[![CTA Image](https://thibaultmilan.com/content/images/2026/11/numbers.png)](https://covid19passbook.netlify.app/?ref=thibaultmilan.com) 

****Covid19-Passbook**  
The farewell page: the story, the numbers, the press review and the thank-yous.

[Visit the farewell page ](https://covid19passbook.netlify.app/?ref=thibaultmilan.com)