This repository contains programming language-neutral specifications and assets for the BlueZone sample application, demonstrating the “Ports and Adapters” architecture pattern featured in the Hexagonal Architecture Explained book.

This pattern—also known as Hexagonal Architecture—promotes a clear separation of concerns by defining ports (interfaces) through which the core application logic interacts with the external world. These ports are then connected to external systems or technologies via adapters.

For a deeper understanding of this architecture, refer to the book Hexagonal Architecture Explained by Alistair Cockburn and Juan Manuel Garrido de Paz.

Technology-specific adapters and implementations of the BlueZone application are provided in separate repositories:

• bluezone-app-py – Python
• bluezone-app-ts – TypeScript

TODO: Expand this list as additional implementations become available.

This structure enables flexibility in choosing or switching between technology stacks.

The BlueZone Sample Application project aims to suggest—without enforcing—a canonical structure for non-trivial applications built using the “Ports and Adapters” architecture pattern.

For more detailed information, see the documentation.

This project is licensed under the MIT License. See the LICENSE file for details.

Contributions are welcome! Please feel free to submit issues, fork the repository, and open pull requests.

For any questions or feedback, contact the author, Asher Sterkin, at [email protected].