Awesome Mercure

A curated list of libraries, integrations, and learning resources around Mercure. Add yours via PR.

#Mercure demos

• Demo hub and debug UI (source): managed demo hub with the official debug tools.
• Chat (source): chat app with presence (JavaScript + Python).

#Mercure code examples

• JavaScript: publish, subscribe, presence API
• JavaScript: subscribe + presence
• Node.js: publish
• PHP: publish
• Ruby: publish
• Python: subscribe
• Python: cookie-based authorization
• API Platform: publish + subscribe: book catalog updated in real time.

#Hubs and server libraries

• Mercure.rocks Hub (Go): the reference implementation.
• Freddie (PHP)
• Ilshidur/node-mercure (Node.js)

#Mercure client libraries

• @microsoft/fetch-event-source (JavaScript): better SSE client for browsers and Node.
• symfony/mercure (PHP, publisher)
• python-mercure (Python, publish + subscribe)
• dart_mercure (Dart / Flutter, publish + subscribe)
• amp-mercure-publisher (PHP / Amphp)
• java-mercure (Java, publisher)
• mercure-rs (Rust, publisher)

#Mercure framework integrations

• Symfony: official component, full publisher support.
• API Platform: full publisher + subscriber + GraphQL subscriptions.
• Laravel Mercure Broadcaster
• Yii Mercure Behavior
• CakePHP Mercure plugin
• Hotwire / Turbo Streams
• GitHub Action: publish on workflow events

#Documentation, tooling, and code generation

• AsyncAPI: natively supports the Mercure protocol.
• URI Template tester: for hubs running 0.x-style URI Template subscriptions.

#Useful SSE and JWT libraries for Mercure

• EventSource polyfill (Edge / IE / old browsers)
• EventSource polyfill for React Native
• EventSource for Node
• Server-Sent Events client for Go
• Server-Sent Events client for Android / Java
• Server-Sent Events client for Swift
• parse-link-header (JavaScript): parse Link: rel="mercure" headers.
• jose (JavaScript): JWT and JWE in the browser and Node.

#Projects using Mercure

• HTTP Broadcast: scalable HTTP broadcaster

#Mercure learning resources

#Mercure resources in english

• 📺 API updates in real time with Mercure.rocks
• 📺 Building async public APIs using HTTP/2+ and the Mercure protocol
• 📺 Real-time notifications with Symfony and Mercure (basics)
• 📺 Real-time chat app with Symfony and Mercure
• Official push and real-time capabilities for Symfony and API Platform
• Tech workshop: Mercure by Kévin Dunglas
• Real-time messages with Mercure using Laravel
• Using Mercure on Stackhero

#Mercure resources in french

• 📺 Notifications instantanées avec Mercure (Grafikart)
• 📺 Live coding: Notifications temps réel avec Mercure
• 📺 Server-Sent Events avec Mercure
• 📺 Mercure: des UIs synchronisées avec les données en BDD
• 📺 Async avec Messenger, AMQP et Mercure
• Mercure, un protocole pour pousser des mises à jour en temps réel (Les-Tilleuls.coop)
• Symfony et Mercure
• À la découverte de Mercure

#Mercure resources in german

• Neue Symfony-Komponente: Mercure ermöglicht Echtzeitübertragung

#Find more Mercure projects

GitHub mercure topic, community-tagged repositories.

#Add your Mercure library or tutorial

PRs welcome. Keep the structure (one bullet per item, language tag for libraries, language flag for learning resources) and aim for things people will actually find useful.