From 8d85b59eac0d90bdd9bd107a10a2f473a0d1f781 Mon Sep 17 00:00:00 2001
From: csagan5 <32685696+csagan5@users.noreply.github.com>
Date: Wed, 29 Jan 2020 09:51:35 +0100
Subject: [PATCH] Mention that Push API does not work due to GCM

Thanks to @randomshell for looking into it.

Fixes #474
---
 README.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/README.md b/README.md
index a832939f..e8111e25 100644
--- a/README.md
+++ b/README.md
@@ -87,6 +87,14 @@ For an Android browser using an alternative engine see [Fennec F-Droid](https://
 ## Does Bromite support extensions?
 No; Bromite will support extensions only if upstream (Chromium) does, or similarly another project maintains the patch and functionality.
 
+## Why do push notifications not work on this website?
+
+The [Chromium Blink engine](https://www.chromium.org/blink) uses [GCM](https://en.wikipedia.org/wiki/Google_Cloud_Messaging) to deliver messages
+when websites use the [Push API](https://w3c.github.io/push-api/); this will not work because cloud integrations are disabled in Bromite (GCM in this case).
+
+[ServiceWorker notifications](https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorkerRegistration/showNotification) do work instead since they use
+[android.app.Notification](https://developer.android.com/guide/topics/ui/notifiers/notifications).
+
 # Features
 
 * customizable adblock filters via user-provided URL