java-service-archetype

Maven archetype that generates a structured multi-module Java service app and optionally using Spring Boot with integration, service, and presentation architectural tiers.

Describe the application’s integrations, service areas, and presentation architectural tiers at generation time; the archetype builds the full module tree and wires up all POMs.

Generate a Project

mvn archetype:generate \
  -DarchetypeGroupId=io.github.jeffjensen \
  -DarchetypeArtifactId=java-service-archetype \
  -DarchetypeVersion=VERSION

Replace VERSION with the archetype release you want to use. See the project site for the full prompts reference, module structure, examples, and build instructions.

CI / CD

Four GitHub Actions workflows are included.

Build any branch (build-any-branch.yml)

Runs ./mvnw clean verify on every push and pull request. Documentation-only changes (.adoc, .md, src/site/**) are skipped — those pushes trigger the site publish directly instead.

Deploy snapshot (deploy-snapshot.yml)

Triggered when the build workflow succeeds on main. Publishes a -SNAPSHOT artifact to Maven Central (Sonatype). Release versions (without -SNAPSHOT) are skipped automatically.

Required repository secrets:

Secret	Description
CENTRAL_USERNAME	Maven Central portal username
CENTRAL_TOKEN	Maven Central portal token

Release (release.yml)

Triggered when maven-release-plugin pushes a v* tag. Runs in a release environment and deploys a GPG-signed release to Maven Central via ./mvnw deploy -Prelease. See the Releasing guide for the full procedure and one-time setup.

Required repository secrets, in addition to CENTRAL_USERNAME and CENTRAL_TOKEN above:

Secret	Description
GPG_PRIVATE_KEY	ASCII-armored GPG private key for artifact signing
GPG_PASSPHRASE	Passphrase for the signing key

Publish site (publish-docs.yml)

Triggered in three ways: when the build workflow succeeds on main; on any direct push to main that touches doc files (.adoc, .md, src/site/**); or manually via workflow_dispatch. Runs ./mvnw site and publishes the Maven site to GitHub Pages.

Enable GitHub Pages (repository Settings → Pages → Source: GitHub Actions) before the first run.