Skip to content

Add web push architecture guide#43419

Open
kovan wants to merge 2 commits intomdn:mainfrom
kovan:push-api-architecture
Open

Add web push architecture guide#43419
kovan wants to merge 2 commits intomdn:mainfrom
kovan:push-api-architecture

Conversation

@kovan
Copy link

@kovan kovan commented Mar 12, 2026

Summary

  • Add a new guide page (Web/API/Push_API/Web_Push_Architecture) explaining how the Web Push infrastructure works end-to-end
  • Covers: subscription flow, push services (Mozilla Autopush, FCM, Apple), message encryption (RFC 8291), VAPID authentication (RFC 8292), delivery headers (TTL, Urgency, Topic), response codes, and subscription lifecycle
  • Links the new guide from the Push API landing page's See Also section

Motivation

The existing Push API docs explain the JavaScript interfaces but not the underlying architecture. Developers need to understand VAPID, encryption, and the delivery protocol to build a working implementation.

As requested in #39747.

Test plan

  • New page renders correctly
  • All internal links resolve
  • See Also link from Push API landing page works

Add a new guide page explaining how the Web Push infrastructure
works end-to-end: subscription flow, push services (Mozilla
Autopush, FCM, Apple), message encryption (RFC 8291), VAPID
authentication (RFC 8292), delivery headers, and subscription
lifecycle.

Fixes mdn#39747
@kovan kovan requested review from a team and mdn-bot as code owners March 12, 2026 23:36
@kovan kovan requested review from caugner and chrisdavidmills and removed request for a team March 12, 2026 23:36
@github-actions github-actions bot added Content:WebAPI Web API docs system [PR only] Infrastructure and configuration for the project size/m [PR only] 51-500 LoC changed labels Mar 12, 2026
@github-actions github-actions bot removed the system [PR only] Infrastructure and configuration for the project label Mar 12, 2026
@caugner caugner removed their request for review March 13, 2026 08:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:WebAPI Web API docs size/m [PR only] 51-500 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant