notiway/notify repository overview

⁠Notiway Notify

A lightweight, extensible gateway for real-time in-app notifications. Built on a pluggable architecture, Notiway runs entirely within your infrastructure — cloud-agnostic, fast, and cost-effective.

⁠Image Variants

⁠portable-{version}

Cloud-agnostic image. Includes the following plugins:

⁠aws-{version}

All cloud-agnostic plugins from portable plus AWS-native plugins:

⁠Quick Start

docker pull notiway/notify:portable-0.6.0
docker run -p 8080:8080 notiway/notify:portable-0.6.0

⁠What It Does

Notiway is a notification gateway that sits between your backend services and client applications. Publish a notification once — Notiway delivers it in real-time to every connected client via WebSocket.

• Real-time delivery — WebSocket connections for instant push to browsers, mobile apps, and desktops
• Flexible routing — Deliver to a single user, a tenant, a group, or broadcast globally
• Multi-tenant — Built-in tenant isolation with configurable validation
• Notification persistence — Store for offline users, replay on reconnect, configurable TTL
• Horizontal scaling — Stateless architecture with automatic cross-instance synchronization
• Multi-client sync — Read/deleted state synchronized across all connected clients

⁠Plugin Architecture

Every infrastructure dependency is a swappable plugin. Choose what fits your stack:

Source code:

• Portable plugins⁠ — RabbitMQ, PostgreSQL, Kubernetes, JWT, Claims
• AWS plugins⁠ — SQS, SNS, DynamoDB, ECS
• Common contracts⁠ — Shared interfaces and models

⁠Configuration

All configuration is done via environment variables or appsettings.json. See the documentation⁠ for the full configuration reference.

⁠Client SDKs

Connect from any platform that supports SignalR:

• JavaScript / TypeScript — @microsoft/signalr
• C# / .NET — Microsoft.AspNetCore.SignalR.Client
• Dart / Flutter — signalr_netcore
• Swift — SwiftSignalRClient
• Kotlin / Java — com.microsoft.signalr

⁠Ports

⁠Documentation

Full documentation: https://notiway.net⁠

⁠License

Notiway core is proprietary. All plugins are open source under the MIT License⁠.