From b71733fe3243493374b6194c7b52d536662518c8 Mon Sep 17 00:00:00 2001 From: Allisson Azevedo Date: Sat, 3 Jan 2026 21:53:52 -0300 Subject: [PATCH] Update README.md with refined project description and features --- README.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 4f46333..f25cc5b 100644 --- a/README.md +++ b/README.md @@ -10,10 +10,11 @@ ### ๐ŸŽฏ What is fastpubsub? -fastpubsub is **not** intended to replace production-grade messaging systems like Google Cloud Pub/Sub, NATS, or Apache Kafka. Instead, it brings key pub/sub features to **simple architectures** where you already have PostgreSQL available. If you're running a small to medium-sized application with PostgreSQL as your primary database, fastpubsub lets you add reliable messaging capabilities without introducing additional infrastructure complexity. +fastpubsub is **not** intended to replace dedicated high-throughput messaging systems like Google Cloud Pub/Sub, NATS, or Apache Kafka. Instead, it brings key pub/sub features to **simple architectures** where you already have PostgreSQL available. If you're running a small to medium-sized application with PostgreSQL as your primary database, fastpubsub lets you add reliable messaging capabilities without introducing additional infrastructure complexity. **Use fastpubsub when you:** - Already use PostgreSQL and want to avoid managing separate message brokers +- Want to keep your stack simple with fewer moving parts - Need pub/sub functionality for small to medium workloads - Prefer simplicity over maximum throughput - Want a single database for both application data and messaging @@ -28,12 +29,13 @@ fastpubsub is **not** intended to replace production-grade messaging systems lik ### โœจ Key Features - ๐ŸŽฏ **Topic-based messaging** - Organize messages by topics +- ๐Ÿ”’ **Secure** - Built-in authentication with JWT and scope-based permissions - ๐Ÿ” **Message filtering** - Subscribe to specific messages using JSON-based filters - ๐Ÿ”„ **Automatic retries** - Configurable retry logic with exponential backoff - ๐Ÿ’€ **Dead Letter Queue (DLQ)** - Handle failed messages gracefully - ๐Ÿ“Š **Metrics & Monitoring** - Built-in subscription metrics and Prometheus support - ๐Ÿณ **Docker-ready** - Easy deployment with Docker -- ๐Ÿ”’ **Reliable delivery** - Acknowledgment and negative-acknowledgment support +- ๐Ÿ›ก๏ธ **Reliable delivery** - Acknowledgment and negative-acknowledgment support - ๐Ÿงน **Automatic cleanup** - Background jobs for message maintenance ## ๐Ÿ—๏ธ Architecture