Automated documentation for event-driven applications built with Spring Boot

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

• About
• Demo & Documentation
• Why You Should Use Springwolf
• Usage & Example
• Who's Using Springwolf
• How To Participate
• Contributors

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.

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

springwolf.dev includes the quickstart guide and full documentation.

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.

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

Plugin	Example project	Current version	SNAPSHOT version
AMQP	AMQP Example
AWS SNS	AWS SNS Example
AWS SQS	AWS SQS Example
Cloud Stream	Cloud Stream Example
JMS	JMS Example
Kafka	Kafka Example
STOMP (WebSocket)	STOMP Example

Click to expand all artifacts, bindings and add-ons

Artifact	Current version	SNAPSHOT version
AsyncAPI implementation
Core
UI

Bindings	Current version	SNAPSHOT version
AMQP Binding
AWS SNS Binding
AWS SQS Binding
Google PubSub Binding
JMS Binding
Kafka Binding
STOMP Binding

Add-on	Current version	SNAPSHOT version
Common Model Converter
Generic Binding
Json Schema
Kotlinx Serialization Model Converter

• 2bPrecise
• aconium
• Alten Italia
• b.well Connected Health
• DGARNE - Public Service of Wallonia (BE)
• LVM Versicherung
• OTTO
• Teambank

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

Check out our CONTRIBUTING.md guide.

repositories {
    // ...
    maven {
        url "https://s01.oss.sonatype.org/content/repositories/snapshots" // build.gradle
        // url = uri("https://s01.oss.sonatype.org/content/repositories/snapshots") // build.gradle.kts
    }
}

<repositories>
    <repository>
        <id>oss-sonatype</id>
        <name>oss-sonatype</name>
        <url>https://s01.oss.sonatype.org/content/repositories/snapshots</url>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
    </repository>
</repositories>

Thanks goes to these wonderful people (emoji key):

Stav Shamir 💻	Timon Back 💻	sam0r040 💻	Carlos Tasada 💻	jrlambs 💻	DmitriButorchin 💻	Thomas Vahrst 💻
Yasen Pavlov 💻	Arthur Geweiler 💻	CS-BASF 💻	Jeroen van Wilgenburg 💻	Michael Strelchenko 💻	Olivier Gaudefroy 💻	Omerbea 💻
Pavel Bodiachevskii 💻	Sergio Roldán 💻	Stmated 💻	Themistoklis Pyrgiotis 💻	Zach Hubbs 💻	biergit 💻	kalarani 💻
Dipesh Singh 💻	Sakshi Jain 💻	Sheheryar Aamir 💻	jmwestbe 💻	pdalfarr 💻	Krzysztof Kwiecień 💻	Robert Henke 💻
Raphael De Lio 💻	Nikita Marunko 💻	Victor Levitskiy 💻	Christopher Cudennec 💻	dabeck81 💻	Jan Marten 💻	FabianBesner2020 💻
Norbert Wirges 💻

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

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