CategoriesJava

The Map of the Territory — Quarkus, Microservices & AI (Starter Baseline, Minimal)

Summary of goal with this post

You’ll set up a tiny Quarkus service that actually runs on your machine with only the pieces we use right now:

  • One REST endpoint (/hello)

  • Swagger UI (so you can “see” your API)

  • Health endpoints (so you know the app is alive)

No databases. No Kafka. No tracing. We’ll add each of those later, when we really need them.

What we are building?

We’re building a Backend-for-Frontend (BFF) starter. Think of it as the “front door” of your system: simple, predictable, and easy to extend in the next posts. Today, the BFF only says “hello”. That’s deliberate: the goal is to learn the flow—create → run → call → test—without distractions.

By the end, you will:

  • Know how to bootstrap a Quarkus service with the minimum extensions.

  • Understand where code lives and how requests flow.

  • See where documentation (Swagger) and health checks live.

Commands to start the project

1) Scaffold a new Quarkus app (only used features)

We want REST, OpenAPI, and Health.