Articles

Jul 26, 2026

The Master YAML: A Manifest of Your Entire Architecture

As Arcadia Editions grows, no single person knows the whole system anymore. The big picture scatters across dozens of repositories. ZenWave architecture manifest pulls it back into one place with every domain, service and contract and how they connect, without copying any of it. And as you work with your API contracts, the pipeline keeps it current: adding services, artifacts, versions... So this manifest and ZenWave Platform keeps your whole architecture connected and navigable for humans, tools and agents.
Jul 24, 2026

Treat Your Domain Models and APIs as Products

A domain model and the APIs it generates are not implementation details of a service. They are the contracts every consumer depends on. Treating them as products means designing them, validating them, versioning them, publishing them, and evolving them with the same discipline as any software artifact.
Jul 21, 2026

DSL Modeling for APIs: Generate OpenAPI and AsyncAPI from ZDL

Writing YAML by hand is no fun, but you can generate your OpenAPI and AsyncAPI definition files from a Domain Specific Language instead. With ZenWave SDK you convert a compact ZDL model into those contracts, saving time and effort while keeping your APIs aligned with best practices and standards.
Jun 29, 2026

AsyncAPI: Which Reference Strategy to Use and Why

AsyncAPI's $ref lets a client spec point to a provider spec without duplicating it. When that spec drives both application contracts and infrastructure provisioning, the URL behind the $ref is an important decision to answer. A pinned version, a environment alias, or the tip of main: each offer different trade-offs.
Jun 26, 2026

AsyncAPI: Your Application Has Two API Surfaces

The AsyncAPI spec says an application SHOULD describe its operations, but not necessarily all of them in the same spec file. Not all operations are equal: some define the public API surface, what the application offers; others describe internal dependencies, what it needs. It makes sense to model them separately.
Jun 25, 2026

Domain Modeling with ZDL: Aggregates, Commands, Events, and State Machines

ZDL is a compressed blueprint of the business: aggregates, commands, events, and lifecycles captured in one readable model. The point is not that generation replaces design, but the opposite: because the design is written down as ubiquitous language, generation can preserve it across contracts, code, documentation, and tests.
Jun 10, 2026

From ZFL to ZDL: AI-Assisted Domain Model Scaffolding

ZFL describes a business flow with commands, events, services, and sometimes aggregate names. An AI agent can turn that into scaffolding for your service repositories.
Jun 1, 2026 · 6 min read

Completing the ZFL: From Bounded Contexts to Systems

Event Storming has two phases. First you discover the flow. Then you find the centers of gravity. The service field in ZFL is where that second phase becomes explicit, and where you start building the architectural world model.
May 22, 2026 · 4 min read

From Events to Bounded Contexts: Finding Arcadia Editions' Architecture

Large systems become unmanageable when everyone shares the same model. This post walks through the heuristic we used to find those boundaries in Arcadia Editions, looking for the business objects that act as centers of gravity for commands and events, and using the consistency requirement to draw the line around each one
May 14, 2026 · 8 min read

From Event Storming to ZFL: Translating Business Flows into Code

Event Storming gives you sticky notes. ZFL gives them a structured home. Here is how the concepts map.
May 10, 2026 · 7 min read

API First 360: AsyncAPI as the Source of Truth for Code and Infrastructure

API First should not stop at generated code. In event-driven systems, the same AsyncAPI contract should help producers, consumers, and platform teams understand and provision the infrastructure that makes the API real.
May 4, 2026 · 5 min read

Event Storming Arcadia Editions: Discovering the Order Flow

We know what Arcadia Editions wants to deliver. Now we need to discover how. Event Storming is how you turn that conversation into a shared understanding of the business. This is what that looks like in practice.
May 1, 2026 · 3 min read

DDD Problem Space vs Solution Space

The solution space is your business. But only if it needs to be discovered. If it is already known, you are not building a business, you are building a commodity.
Apr 30, 2026 · 4 min read

Meet Arcadia Editions: The Fictional Company I Built to Explore Event-Driven Architecture

Domain discovery, event modeling, API specs, and running code. All of it built in the open, through a domain complex enough to make the decisions interesting.
Apr 26, 2026 · 12 min read

Apicurio Registry Maven Plugin: CLI Mode and Autoconfiguration

Three upstream fixes that make the Apicurio Registry Maven Plugin work from the CLI with minimal configuration
Apr 12, 2026 · 2 min read

AsyncAPI Studio: From Single File to Real World Usage

AsyncAPI Studio was previously a single in-memory file editor. This prevented using relative $refs to external .avsc Avro files. This new contribution now tracks the document source, resolves relative references, and can read and write files directly to disk using the browser's File System Access API when working with a local folder.
Mar 28, 2026 · 4 min read

ZenWave Domain Language (ZDL) now speaks State Machines

Every application has state machine-like transitions: an order that gets placed, paid, shipped, cancelled. Now you can model your state transitions and ZenWave SDK will implement and enforce them for you.
Mar 1, 2026 · 8 min read

Preventing API Drift with AsyncAPI - A Java/Spring Perspective

How strongly-typed code generation, build-time regeneration, and versioned specifications eliminate API drift in Java/Spring projects using OpenAPI and AsyncAPI.
Sep 30, 2025 · 10 min read · Published at adictosaltrabajo.com

DDD en la Práctica: De Lenguaje Ubícuo en DSL a Proyecto Completo de Spring Boot con Kotlin

En este artículo exploraremos cómo utilizar ZenWave360 para generar un proyecto completo de Spring Boot con Kotlin a partir de un modelo DSL de Lenguaje Ubicuo.
Sep 1, 2025 Featured · 20 min read · Published at ZenWave360

DDD In Practice: From Ubiquitous Language DSL to Complete Spring-Boot Kotlin Project

How to use ZenWave SDK to implement DDD principles in practice, from Event Storming discoveries to a complete Spring Boot Kotlin project using ZDL as Ubiquitous Language.
Sep 1, 2025 · 12 min read · Published at adictosaltrabajo.com

Spring Boot con Kotlin frente a Java: Comparativa práctica y guía de integración empresarial

Análisis práctico del desarrollo con Spring Boot usando Kotlin frente a Java, comparando sintaxis, productividad e integración con herramientas como OpenAPI, AsyncAPI y Avro en un entorno empresarial.
Jul 1, 2025 · 3 min read · Published at ZenWave360

SpringBoot + Kotlin is coming to ZenWaveSDK

Announcement of ZenWave SDK 2.0.0 release and upcoming Kotlin support for generating well-structured Spring Boot applications with OpenAPI and AsyncAPI support.
Apr 23, 2025 · 7 min read · Published at adictosaltrabajo.com

Evitando el API Drift en APIs asincronas con AsyncAPI y ZenWave SDK

Evita errores y pérdida de alineación en tus APIs asíncronas. Descubre cómo AsyncAPI y ZenWave SDK pueden ayudarte a prevenir el API Drift mediante generación de código automatizada y buenas prácticas DevOps.
Mar 20, 2025 · 9 min read · Published at adictosaltrabajo.com

Implementando un Outbox Transaccional con AsyncAPI, SpringModulith y ZenWaveSDK

Aprende a implementar un Outbox Transaccional con AsyncAPI, SpringModulith y ZenWaveSDK, garantizando la consistencia y externalizacion eficiente de eventos en arquitecturas distribuidas.
Mar 3, 2025 · 9 min read · Published at ZenWave360

Transactional OutBox With AsyncAPI SpringCloud Stream And Spring Modulith

Implementing transactional outbox pattern using AsyncAPI, Spring Cloud Stream, and Spring Modulith as part of ZenWave 360º approach.
Mar 1, 2025 · 8 min read · Published at ZenWave360

Externalize Spring-Modulith Events with Spring Cloud Stream

Introducing a new library that provides a Spring Modulith event externalizer for Spring Cloud Stream, enabling multi-broker support, flexible message headers, and Avro serialization.
Oct 4, 2024 · 8 min read · Published at ZenWave360

From OpenAPI to KarateDSL Tests with ZenWave SDK

How to save time and typing by generating KarateDSL tests automatically from OpenAPI definitions using ZenWave SDK.
Sep 24, 2024 · 7 min read · Published at Medium

Generate OpenAPI from ZenWave Domain Language

Use ZenWave Domain Language (a compact DSL) as IDL to generate OpenAPI v3 specs instead of hand-writing YAML.
Aug 30, 2024 · 6 min read · Published at Medium

Debugging KarateDSL Scripts in VSCode (Open Source)

The only free and open-source way to debug KarateDSL scripts in Visual Studio Code, bringing back first-class debug support.
Jan 1, 2024 · 10 min read · Published at ZenWave360

ZenWave 360º Business Domain Modeling

How ZenWave 360º enables business domain modeling using DDD principles, ZDL as Ubiquitous Language, and ZenWave SDK to convert domain models into software artifacts.
Jan 1, 2024 · 7 min read · Published at ZenWave360

ZenWave 360º Event Storming

A guide to Event Storming as a collaborative workshop technique for exploring complex business domains, and how ZDL maps Event Storming discoveries into a developer-friendly format.
Apr 29, 2023 · 5 min read · Published at Medium

JDL To AsyncAPI v2

Convert JHipster JDL models into AsyncAPI definition files using ZenWave SDK.
Apr 29, 2023 · 5 min read · Published at Medium

JDL To OpenAPI

Convert JHipster JDL models into OpenAPI definition files using ZenWave SDK.
Mar 3, 2023 · 6 min read · Published at Medium

API-First with AsyncAPI

Applying API-First principles using AsyncAPI, similar to the OpenAPI process.
Mar 3, 2023 · 7 min read · Published at Medium

ZenWave AsyncAPI Code Generator

Generate strongly typed Java interfaces, DTOs, and headers from AsyncAPI definitions using ZenWave SDK plugins.
Apr 7, 2022 · 10 min read · Published at Medium

High Fidelity Stateful Mocks (Consumer Contracts) with OpenAPI and KarateDSL

Create high-fidelity stateful mocks for REST APIs using OpenAPI, KarateDSL, and ZenWave APIMock for contract testing.
Feb 3, 2022 · 8 min read · Published at Medium

From Manual to Contract Testing with KarateDSL and KarateIDE

Guide to moving from manual testing to contract testing using OpenAPI, KarateDSL, and the KarateIDE VSCode extension.