SELF-HOSTED ยท OPEN SOURCE ยท PWA PUSH

PUSH NOTIFICATION
SERVER

Lightweight, self-hosted notifications. Subscribe via SSE, publish with curl. No cloud, no dependencies, no complexity.

OPEN DASHBOARD โ†’npm run dev
CORE FEATURES

Main Facts
About Beacon

๐Ÿ“ก

REAL-TIME SSE

Server-Sent Events deliver messages the moment they arrive. No polling, no WebSocket overhead.

๐Ÿ“ฑ

WEB PUSH

Get push notifications on your phone via PWA. Works on Android Chrome and iOS Safari โ€” no app store needed.

๐Ÿ—„๏ธ

PERSISTENT HISTORY

SQLite-backed storage means you never miss a message. Reconnect and replay what you missed.

๐Ÿ”

TOKEN AUTH

Secure your server with a single environment variable. Browser login page + Bearer token for scripts.

โœˆ๏ธ

TELEGRAM RELAY

Forward every message to a Telegram bot. Get notified anywhere when you are away from your desk.

โฑ๏ธ

TTL & AUTO-CLEANUP

Set an expiry on any message. Expired entries are hidden from queries and purged every 10 minutes.

GET STARTED

Up and Running
In Three Steps

01

Start the server

Clone, install, and run. Beacon binds to all interfaces so any device on your network can reach it.

npm install
npm run dev -- --hostname 0.0.0.0
02

Subscribe to a topic

Open any topic URL in your browser โ€” or subscribe programmatically with EventSource. Topics are created on demand.

new EventSource('/api/my-topic')
03

Publish a message

POST to any topic from a script, CI pipeline, or cron job. Plain text or JSON โ€” your choice.

curl -d 'Hello' localhost:3000/api/topic
1
Pick a topic
Type any topic name โ€” topics are created on demand, no setup needed.
2
Write your message
Plain text or JSON. Add a priority level (low, high, urgent) if you want.
3
Send it
Hit send or POST via curl. The message arrives in under a second.
4
Get notified
A notification pops on your device. SSE delivers it in real-time.
TECH STACK
Next.js 16SQLiteSSETypeScriptPWA
0
External deps
<1s
Delivery latency
โˆž
Unlimited topics
๐Ÿ“ฑ
Web Push
โšก
SSE real-time

PARTICIPATE IN
THE BETA

Beacon is running locally. Open the dashboard and send your first notification right now.

OPEN BEACON โ†’