Skip to content

v0.1.0

Choose a tag to compare

@saiday saiday released this 08 Aug 14:10
· 44 commits to main since this release

First published release: npm install kukuroo now works.

Kukuroo sends Web Push notifications to your own devices from anything that can
make an HTTP request. A Cloudflare Worker plus KV holds the subscriptions and
signs the pushes itself, so there is no third-party notification service in the
path and no app to install.

  • npx kukuroo init scaffolds a standalone Worker, or mounts the routes into a
    Worker you already have. It asks what it needs and generates every secret up
    front.
  • Works with an existing website on any host: a subscription binds to the
    enrolling page's origin and the VAPID keypair, never the Worker's address.
    Five topologies are documented in the README.
  • Cross-origin enrolment via KUKUROO_ALLOWED_ORIGINS (exact origins, no
    wildcard). send is never CORS-enabled, by design.
  • Declarative Web Push, so iOS 16.4+ Home Screen web apps get notifications
    with no service worker.

Early software: tested end to end against a real iPhone, but installed by
exactly one person so far. Please report rough edges.