Dev

[Ifaz-Ikram]

This pull request introduces a custom "MediCare" Keycloak theme and updates the Keycloak development environment to support it. It enhances the authentication experience with custom UI, improves realm configuration, and ensures the local development setup loads the new theme and configuration automatically.

Keycloak Theme Integration and UI Enhancements:

• Added a new custom theme for Keycloak under development/keycloak/themes/medicare, including tailored login, registration, password reset, error, and info pages (login.ftl, register.ftl, login-reset-password.ftl, error.ftl, info.ftl), a modern CSS stylesheet, and theme properties. This provides a cohesive, branded user experience for MediCare authentication. [1] [2] [3] [4] [5] [6] [7]

Keycloak Realm and Client Configuration:

• Updated realm-config.json to:
  • Set the login theme to "medicare"
  • Add a new "admin" realm role
  • Expand the medicare client configuration with a name, secret, base URL, additional redirect URIs, post-logout redirect URIs, and web origins for local development. [1] [2] [3]

Development Environment Updates:

• Modified docker-compose.yaml to:
  • Pin the Keycloak image to version 26.6.1 for stability
  • Add the --import-realm flag to the Keycloak startup command so the realm config is loaded automatically
  • Mount the custom theme and realm config as read-only volumes for the Keycloak container [1] [2]

[Copilot]

Pull request overview

This PR adds a custom “MediCare” Keycloak login theme and updates the local Keycloak development setup to automatically load that theme and an updated realm configuration.

Changes:

• Introduces a new Keycloak login theme (medicare) with custom FreeMarker templates and styling.
• Updates the Keycloak realm import to use the new login theme and expands the medicare client configuration (redirect URIs, web origins, post-logout redirects, secret).
• Updates local docker-compose.yaml to pin the Keycloak image version, import the realm on startup, and mount the theme + realm config into the container.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
development/keycloak/themes/medicare/login/theme.properties	Declares theme inheritance and CSS resource.
development/keycloak/themes/medicare/login/resources/css/login.css	Adds MediCare-specific styling for Keycloak auth pages.
development/keycloak/themes/medicare/login/login.ftl	Custom login page template.
development/keycloak/themes/medicare/login/register.ftl	Custom registration page template.
development/keycloak/themes/medicare/login/login-reset-password.ftl	Custom password reset request page template.
development/keycloak/themes/medicare/login/info.ftl	Custom informational page template.
development/keycloak/themes/medicare/login/error.ftl	Custom error page template.
development/keycloak/realm-config.json	Sets loginTheme and expands realm roles + client configuration.
development/docker-compose.yaml	Pins Keycloak version, enables realm import, and mounts theme/realm config volumes.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.