README.md

April 6, 2026 Β· View on GitHub

Logo Springwolf

Automated documentation for event-driven applications built with Spring Boot

Last Version GitHub commits since latest release (by SemVer including pre-releases) License

springwolf-core springwolf-asyncapi springwolf-ui springwolf-plugins springwolf-addons

We are on discord for any question, discussion, request etc. Join us at https://discord.gg/HZYqd5RPTd

Contents

About

This project is inspired by Springfox. It documents asynchronous APIs using the AsyncAPI specification.

springwolf-ui adds a web UI, much like that of Springfox, and allows easy publishing of auto-generated payload examples.

πŸͺ‡ Demo & πŸ“– Documentation

Take a look at the Springwolf live demo and a generated AsyncAPI document.

springwolf.dev includes the quickstart guide and full documentation.

✨ Why You Should Use Springwolf

Springwolf exploits the fact that you already fully described your consumer endpoint (with listener annotations, such as @KafkaListener, @RabbitListener, @SqsListener, etc.) and generates the documentation based on this information.

Share API Schema Definition

The AsyncAPI conform documentation can be integrated into API hubs (like backstage) or be shared as a json/yaml file with others.

UI Based API Testing

In projects using asynchronous APIs, you may often find yourself needing to manually send a message to some topic, whether you are manually testing a new feature, debugging or trying to understand some flow.

Using the automatically generated example payload object as a suggestion, you can publish it to the correct channel with a single click.

πŸ”¬ Usage & Example

Protocols not supported natively can still be documented using @AsyncListener and @AsyncPublisher annotation. More details in the documentation.

PluginExample projectCurrent versionSNAPSHOT version
AMQPAMQP ExampleMaven CentralSonatype Nexus (Snapshots)
AWS SNSAWS SNS ExampleMaven CentralSonatype Nexus (Snapshots)
AWS SQSAWS SQS ExampleMaven CentralSonatype Nexus (Snapshots)
Cloud StreamCloud Stream ExampleMaven CentralSonatype Nexus (Snapshots)
JMSJMS ExampleMaven CentralSonatype Nexus (Snapshots)
KafkaKafka ExampleMaven CentralSonatype Nexus (Snapshots)
STOMP (WebSocket)STOMP ExampleMaven CentralSonatype Nexus (Snapshots)
Click to expand all artifacts, bindings and add-ons
ArtifactCurrent versionSNAPSHOT version
AsyncAPI implementationMaven CentralSonatype Nexus (Snapshots)
CoreMaven CentralSonatype Nexus (Snapshots)
UIMaven CentralSonatype Nexus (Snapshots)
BindingsCurrent versionSNAPSHOT version
AMQP BindingMaven CentralSonatype Nexus (Snapshots)
AWS SNS BindingMaven CentralSonatype Nexus (Snapshots)
AWS SQS BindingMaven CentralSonatype Nexus (Snapshots)
Google PubSub BindingMaven CentralSonatype Nexus (Snapshots)
JMS BindingMaven CentralSonatype Nexus (Snapshots)
Kafka BindingMaven CentralSonatype Nexus (Snapshots)
STOMP BindingMaven CentralSonatype Nexus (Snapshots)
Add-onCurrent versionSNAPSHOT version
Common Model ConverterMaven CentralSonatype Nexus (Snapshots)
Generic BindingMaven CentralSonatype Nexus (Snapshots)
Json SchemaMaven CentralSonatype Nexus (Snapshots)
Kotlinx Serialization Model ConverterMaven CentralSonatype Nexus (Snapshots)

πŸš€ Who's Using Springwolf

Comment in this PR to add your company and spread the word

✏️ How To Participate

Check out our CONTRIBUTING.md guide.

Testing SNAPSHOT version

Sonatype snapshots

Add the following to the repositories closure in build.gradle:

repositories {
    // ...
    maven {
        url "https://central.sonatype.com/repository/maven-snapshots/" // build.gradle
        // url = uri("https://central.sonatype.com/repository/maven-snapshots/") // build.gradle.kts
    }
}

Or add the repository to your pom.xml if you are using maven:


<repositories>
    <repository>
        <id>oss-sonatype</id>
        <name>oss-sonatype</name>
        <url>https://central.sonatype.com/repository/maven-snapshots/</url>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
    </repository>
</repositories>

Local Snapshot Build

To test with local builds, run the publishToMavenLocal gradle task. The current version number is set in .env file.

Do not forget to add mavenLocal() to the repositories section.

πŸ‘ Contributors

Thanks goes to these wonderful people (emoji key):

Stav Shamir
Stav Shamir

πŸ’»
Timon Back
Timon Back

πŸ’»
sam0r040
sam0r040

πŸ’»
Carlos Tasada
Carlos Tasada

πŸ’»
jrlambs
jrlambs

πŸ’»
DmitriButorchin
DmitriButorchin

πŸ’»
Thomas Vahrst
Thomas Vahrst

πŸ’»
Yasen Pavlov
Yasen Pavlov

πŸ’»
Arthur Geweiler
Arthur Geweiler

πŸ’»
CS-BASF
CS-BASF

πŸ’»
Jeroen van Wilgenburg
Jeroen van Wilgenburg

πŸ’»
Michael Strelchenko
Michael Strelchenko

πŸ’»
Olivier Gaudefroy
Olivier Gaudefroy

πŸ’»
Omerbea
Omerbea

πŸ’»
Pavel Bodiachevskii
Pavel Bodiachevskii

πŸ’»
Sergio RoldΓ‘n
Sergio RoldΓ‘n

πŸ’»
Stmated
Stmated

πŸ’»
Themistoklis Pyrgiotis
Themistoklis Pyrgiotis

πŸ’»
Zach Hubbs
Zach Hubbs

πŸ’»
biergit
biergit

πŸ’»
kalarani
kalarani

πŸ’»
Dipesh Singh
Dipesh Singh

πŸ’»
Sakshi Jain
Sakshi Jain

πŸ’»
Sheheryar Aamir
Sheheryar Aamir

πŸ’»
jmwestbe
jmwestbe

πŸ’»
pdalfarr
pdalfarr

πŸ’»
Krzysztof KwiecieΕ„
Krzysztof KwiecieΕ„

πŸ’»
Robert Henke
Robert Henke

πŸ’»
Raphael De Lio
Raphael De Lio

πŸ’»
Nikita Marunko
Nikita Marunko

πŸ’»
Victor Levitskiy
Victor Levitskiy

πŸ’»
Christopher Cudennec
Christopher Cudennec

πŸ’»
dabeck81
dabeck81

πŸ’»
Jan Marten
Jan Marten

πŸ’»
FabianBesner2020
FabianBesner2020

πŸ’»
Norbert Wirges
Norbert Wirges

πŸ’»
Tomas Tulka
Tomas Tulka

πŸ’»
Elys Rivero
Elys Rivero

πŸ’»
AlexElin
AlexElin

πŸ’»
antoine VAISSET
antoine VAISSET

πŸ’»
Karlender
Karlender

πŸ’»
Steffen
Steffen

πŸ’»
risingcult
risingcult

πŸ’»
Hamzeh Adawi
Hamzeh Adawi

πŸ’»
Haisia
Haisia

πŸ’»
Emanuel Trandafir
Emanuel Trandafir

πŸ’»
Revan Channa
Revan Channa

πŸ’»
Skypha
Skypha

πŸ’»
Adrien-dev25
Adrien-dev25

πŸ’»

To add yourself as a contributor, install the all-contributors CLI and run:

  1. npx all-contributors-cli check
  2. npx all-contributors-cli add <username> code
  3. npx all-contributors-cli generate