// readme

HKID Appointment Quota Dashboard

Monitors smart ID card appointment quotas at the six Registration of Persons offices of the Hong Kong Immigration Department, checking about every 2 minutes, and notifies subscribers via email / Feishu group when slots are released. This is a third-party public-interest tool, not an official Immigration Department service. It only monitors and sends alerts; it does not snatch or book appointments on anyone’s behalf.

Dashboard entry

  • Preferred (stable direct access from mainland China): https://hkid-quota-monitor.pages.dev/
  • Backup: https://chen1111-a.github.io/hkid-quota-monitor/ (Access to github.io from mainland networks is intermittent; jsDelivr/raw direct links carry a nosniff header and only display source code, so don’t use them as web entry points)
  • The full experience in mainland China without a VPN is email subscription + Feishu group. The notification path is entirely direct within China and pushes releases to your phone right away; the dashboard is only a helper

How it works

cron-job.org (every 2 minutes) ──▢ GitHub Actions
                            β”‚  python -m quota_monitor.run…