spring-boot-4-openapi-archetype

Maven Archetype for generating basic Java 25 Spring Boot 4 projects with OpenAPI support.

Getting Started

Build

#!/usr/bin/env bash
./mvnw clean install

Usage

#!/usr/bin/env bash

mvn archetype:generate \
  -DarchetypeGroupId="com.muneebkhawaja" \
  -DarchetypeArtifactId="spring-boot-4-openapi-archetype" \
  -DarchetypeVersion="1.0.0" \
  -DgroupId="com.example" \
  -DartifactId="api" \
  -Dpackage="com.example.api" \
  -Dversion="0.0.1-SNAPSHOT" \
  -B

Alternatively, you can use docker and volume binding to generate the project:

#!/usr/bin/env bash

docker build -t mtkhawaja/spring-boot-4-openapi-archetype:latest .
docker run \
  -v ./:/opt/application/generated \
  -e GENERATED_GROUP_ID="com.example" \
  -e GENERATED_ARTIFACT_ID="api" \
  -e GENERATED_PACKAGE="com.example.api" \
  -e GENERATED_VERSION="0.0.1-SNAPSHOT" \
  mtkhawaja/spring-boot-4-openapi-archetype:latest

This will generate a project with the following directory structure:

#!/usr/bin/env bash

tree -a ./api

./api
├── Dockerfile
├── mvnw
├── mvnw.cmd
├── pom.xml
├── README.md
├── src
│   ├── main
│   │   ├── java
│   │   │   └── com
│   │   │       └── example
│   │   │           └── api
│   │   │               ├── Application.java
│   │   │               └── ExampleController.java
│   │   └── resources
│   │       ├── application.yaml
│   │       └── openapi-spec.yaml
│   └── test
│       └── java
│           └── com
│               └── example
│                   └── api
│                       ├── ApplicationSmokeTest.java
│                       └── ExampleControllerTest.java

License

Apache License Version 2.0