Skip to Content
Pocket Notifier

Pocket Notifier

Self-hosted, invite-only push notifications for scripts, CI and servers, delivered to an Android-first app.

Pocket Notifier is a notification service in the spirit of ntfy: anything that can make an HTTP request can send a message to a project, and everyone subscribed to that project gets a push notification on their phone.

It runs on your own Cloudflare account, is shared with a small group of invited people, and uses its own API rather than ntfy's.

Publish a message
curl https://notifier.bartuozel.com/api/v1/projects/deploys/messages \
  -H "Authorization: Bearer nt_..." \
  -H "Content-Type: application/json" \
  -d '{"title":"Prod deploy finished","body":"v1.42.0 is live","priority":4}'

How it fits together

Status

This documentation is the specification for v1. Nothing beyond the starter template is built yet.

Every design point is labelled:

  • Decided agreed and ready to build.
  • Open a proposal that still needs a decision.
  • Later deliberately out of v1.

The decision log lists them all in one place.

Where things live

server/ — Hono Worker: public API, app API, push sender
web/ — Next.js dashboard
native/ — Expo app, Android first
fumadocs/ — these docs
contract/ — API contracts and wire formats (source of truth)
api/ — procedure implementations
auth/ — better-auth setup
db/ — Drizzle schema for D1
infra/ — Alchemy stack (Workers, D1, R2)

The contract is the source of truth

Request and response shapes, limits and error codes are defined in code in packages/contract. These pages explain behaviour and the reasons behind it; when a page and the contract disagree, the contract wins and the page needs fixing.

On this page