<div align="center">
<img src="artwork/macula-alt-logo.svg" alt="Macula Logo" width="500"/>
<h1>Macula HTTP/3 Mesh</h1>
<p><em>Self-organizing distributed mesh for decentralized applications</em></p>
<p>
<a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License"/></a>
<a href="https://www.erlang.org"><img src="https://img.shields.io/badge/Erlang%2FOTP-26+-brightgreen" alt="Erlang/OTP"/></a>
<a href="https://hex.pm/packages/macula"><img src="https://img.shields.io/hexpm/v/macula.svg" alt="Hex.pm"/></a>
</p>
</div>
---
<div align="center">
<img src="assets/macula-architecture-overview.svg" alt="Macula Architecture Overview" width="800"/>
</div>
<div align="center">
<p><strong>BEAM-Native • HTTP/3 (QUIC) • Kademlia DHT • NAT Traversal • Multi-Tenant • Platform Layer</strong></p>
</div>
---
## Documentation
- 🚀 **[Getting Started](GETTING_STARTED.md)** - Installation, quick start, code examples
- 🏗️ **[Architecture Guide](ARCHITECTURE.md)** - Visual guide with C4 diagrams, deployment topologies
- 📄 **[Changelog](CHANGELOG.md)** - Version history and migration guides
- 🧪 **[Development Guide](docs/DEVELOPMENT.md)** - Contributing and testing
- 🌐 **[DHT Guide](docs/guides/DHT_GUIDE.md)** - Kademlia DHT architecture
---
## Latest Release: v0.12.5 (2025-11-30)
**NAT Traversal & Connectivity:**
- ✅ Complete NAT traversal with hole-punching and relay fallback
- ✅ Connection pooling with 94.5% hit rate
- ✅ Docker NAT simulation for testing (Full Cone, Restricted, Symmetric)
**NATS-style Async RPC:**
- ✅ Fire-and-forget request pattern with inbox callbacks
- ✅ Direct P2P delivery (not routed through Bootstrap)
- ✅ Pull-based service discovery with prefetch on startup
**PubSub Delivery Metrics:**
- ✅ Sequence numbers and per-peer delivery tracking
- ✅ Colored console output for demos (ANSI colors)
- ✅ Delivery rate calculations per sender
**Platform Features (v0.9.0+):**
- ✅ Ra/Raft consensus for distributed coordination
- ✅ LWW-Register CRDT for eventually-consistent state
- ✅ Leader election and workload registration APIs
---
## Community
- **Hex**: [hex.pm/packages/macula](https://hex.pm/packages/macula)
- **GitHub**: [github.com/macula-io/macula](https://github.com/macula-io/macula)
- **Issues**: [github.com/macula-io/macula/issues](https://github.com/macula-io/macula/issues)
---
**Built with ❤️ for the BEAM community**
