bonk: push notifications

push notifications in one curl

bonk is a push notification webhook. One HTTP POST, one push on every device you have paired. No SDK, no dashboard, no sign-up. The app is your account.

HOW IT WORKS

1. Open bonk. The app provisions an anonymous account and mints your first webhook secret — shown exactly once.
2. From anywhere that speaks HTTP, POST to your URL.
3. Every paired device lights up.

WHAT YOU CAN SEND

Plain text becomes the notification body. For richer pushes, send application/json with any of:

• title — bold first line; defaults to "bonk"
• body — the message; falls back to the raw body
• url — tapping the notification opens this link
• image — an iOS preview image URL (HTTPS)
• level — active, passive, time-sensitive, or critical

WHO IT'S FOR

Solo developers wiring up push notifications for their own devices. CI pipelines that finished a build. Cron jobs that want to brag. Autonomous agents that need a human's attention. Uptime checks that blew up at 3am. Anything that can make an HTTP request and should wake you up.

WHAT'S IN THE APP

• The feed — every bonk that's landed on your account, newest first
• Webhooks — create, rotate, revoke; secrets are shown exactly once
• Settings — pair more devices via 6-digit code, delete your account

PAIRING DEVICES

Add another phone, iPad, or Mac to the same account with a 6-digit code from Settings. Any bonk fans out to all of them in under a second.

PRIVACY

• No email, no password, no OAuth — opening the app is the entire sign-up
• No dashboard — your lock screen is the UI
• Notification bodies are forwarded to the push gateway and dropped; we don't keep them

RATE LIMITS

300 requests per minute per webhook secret. Enough for every sane alerting and CI integration. Email if you need more.