💀 QAdmin Skeleton

An early work-in-progress starter for small Quarkus apps featuring:

• Form-based authentication (Quarkus Security with users/roles)
• Server-side HTML with Qute templates
• Progressive enhancement with htmx
• Hibernate ORM with Panache and Flyway migrations
• Opinionated structure, basic CRUD for users, and ready-to-run dev/test setups

This aims to be a clean foundation you can clone and extend: a simple dashboard, login/logout, user management, templates, styles, and tests-without the bloat of a full admin suite.

Features

• Authentication and Authorization

  • Form login at /auth/login, landing page /
  • Role-based access (admin, user)

• UI

  • Qute templates with a minimal layout, navbar, sidebar and components
  • htmx sprinkled for snappy UX with minimal JS

• Data

  • PostgreSQL (DevServices or local DB)
  • Flyway migrations per profile (dev/test/prod)
  • Panache entities and repositories

• Developer Experience

  • Quarkus dev mode (hot reload)
  • JUnit tests with helpers and clean DB per test

Quickstart

Prerequisites

• Java 21+

Run in dev mode (hot reload)

• ./mvnw quarkus:dev

Run tests

• ./mvnw test

Build a package

• ./mvnw package

What’s included

• Templates

  • src/main/resources/templates (layout, components, pages)

• Web assets

  • SCSS and JS under src/main/resources/web/app

• Migrations and data

  • Base schema: src/main/resources/db/migration
  • Dev seed: src/main/resources/db/migration-dev
  • Test seed: src/main/resources/db/migration-test
  • Dev/Test profiles automatically apply seeds (see application.properties)

License

MIT