Home

Concepts

palmpush is intentionally small. These are the concepts that matter.

Listener

A listener is a private notification endpoint.

Each listener has a random listener id. The send URL is built from that id:

txt
https://push.palmpush.com/send/<listener-token>

Anyone with the listener id can send to the listener, subscribe another device, and rename the listener. Treat it like a secret.

Device

A device is one app or browser installation.

The iOS app creates a local device id on first launch. The PWA SDK does the same in localStorage.

There are no user accounts in v1. If you lose a device install, subscribe again with the listener id.

Delivery settings

There are two switches in the iOS app:

  • listener enabled controls the whole listener. When it is off, palmpush skips delivery and does not write history for new sends.
  • enabled for this device controls only the current device. When it is off, this device does not receive pushes, but history still shows muted events.

History

Each subscribed device can view its own listener history.

Events can be Sent, Failed, Muted, or Pending. Muted means the send happened while this device was disabled for that listener.

Delete

Delete removes the listener from the current device.

Other subscribed devices stay subscribed. If this was the last subscribed device, the backend deletes the listener.

Current limits

  • Only title and body notifications are supported.
  • There are no accounts or API keys.
  • There is no scheduling.
  • There are no image attachments.
  • Listener ids are the security boundary.