beebuzz

module
v0.9.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Apr 23, 2026 License: AGPL-3.0

README

BeeBuzz

BeeBuzz is a web push notification system with an installable client, a hosted beta, and a CLI for sending messages fast.

Start Here

Beta Focus

BeeBuzz is currently optimized for two workflows:

  1. get approved for the beta and send your first notification in seconds
  2. run the stack locally with a fast development loop

Detailed production self-hosting docs will come later.

Install The CLI

go install lucor.dev/beebuzz/cmd/beebuzz@latest

License

BeeBuzz is licensed under the GNU Affero General Public License v3.0 only.

Directories

Path Synopsis
cmd
beebuzz command
beebuzz-server command
Package main contains adapter implementations that bridge domain services to handlers and middleware.
 Package main contains adapter implementations that bridge domain services to handlers and middleware.
internal
admin
attachment
Package attachment handles temporary attachment storage and secure token-based retrieval.
 Package attachment handles temporary attachment storage and secure token-based retrieval.
auth
Package auth handles user authentication via OTP and session management.
 Package auth handles user authentication via OTP and session management.
config
core
Package core provides shared HTTP helpers, common error values, and small cross-domain utilities that can be reused without introducing domain coupling.
 Package core provides shared HTTP helpers, common error values, and small cross-domain utilities that can be reused without introducing domain coupling.
database
Package database provides a SQLite database connection for Beebuzz.
 Package database provides a SQLite database connection for Beebuzz.
device
Package device manages device registration, pairing, and push subscriptions.
 Package device manages device registration, pairing, and push subscriptions.
event
Package event tracks notification events and daily usage summaries.
 Package event tracks notification events and daily usage summaries.
health
httpfetch
Package httpfetch provides an SSRF-safe HTTP client for fetching external URLs.
 Package httpfetch provides an SSRF-safe HTTP client for fetching external URLs.
logger
Package logger provides a logger for structured logging.
 Package logger provides a logger for structured logging.
mailer
Package mailer provides an abstraction for sending HTML emails It supports multiple sending backends (SMTP, API-based services), asynchronous sending, retry logic, and fallback to logging when no email provider is configured.
 Package mailer provides an abstraction for sending HTML emails It supports multiple sending backends (SMTP, API-based services), asynchronous sending, retry logic, and fallback to logging when no email provider is configured.
middleware
migrations
Package migrations provides SQLite database migrations for Beebuzz.
 Package migrations provides SQLite database migrations for Beebuzz.
monitoring
notification
Package notification handles dispatching push notifications to subscribed devices via Web Push.
 Package notification handles dispatching push notifications to subscribed devices via Web Push.
push
Package push defines shared BeeBuzz push protocol constants.
 Package push defines shared BeeBuzz push protocol constants.
secure
Package secure provides utilities for generating and handling cryptographically secure tokens intended for authentication, API keys, and other security-sensitive use cases.
 Package secure provides utilities for generating and handling cryptographically secure tokens intended for authentication, API keys, and other security-sensitive use cases.
testutil
Package testutil provides shared test helpers for all domain packages.
 Package testutil provides shared test helpers for all domain packages.
token
Package token manages API tokens used for authenticating external clients.
 Package token manages API tokens used for authenticating external clients.
topic
Package topic manages notification topics owned by users.
 Package topic manages notification topics owned by users.
user
Package user manages user accounts and profile data.
 Package user manages user accounts and profile data.
validator
Package validator provides simple, composable validation functions.
 Package validator provides simple, composable validation functions.
webhook
Package webhook manages webhooks that dispatch push notifications on incoming HTTP payloads.
 Package webhook manages webhooks that dispatch push notifications on incoming HTTP payloads.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.