keycloak-theming

Apply realm-specific Keycloak authentication theming using FreeMarker templates and JWT claims.

18|2|Updated Dec 12, 2025
One-click install
npx skills add https://github.com/markus41/claude --skill keycloak-theming
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: keycloak-theming
Source: https://github.com/markus41/claude/tree/main/plugins/frontend-design-system/skills/keycloak-theming
Command: npx skills add https://github.com/markus41/claude --skill keycloak-theming

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the process of applying unique, multi-tenant branding and design systems to Keycloak authentication pages across different realms.

Core Features & Use Cases

  • Realm-Specific Theming: Apply distinct visual styles (logos, colors, fonts) to Keycloak login, account, and email pages for each tenant.
  • Design System Integration: Incorporate established design system tokens and components into Keycloak themes for brand consistency.
  • Use Case: A SaaS platform with multiple enterprise clients can use this Skill to ensure each client's login portal perfectly matches their brand identity, enhancing user trust and experience.

Quick Start

Configure the 'lobbi-theme' for the 'thelobbi' Keycloak realm by updating the theme properties and FTL templates.

Frequently Asked Questions about keycloak-theming

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I apply custom Keycloak themes for multi-tenant branding?

To apply custom Keycloak themes for multi-tenant branding, configure realm-specific design systems by updating theme properties and FreeMarker templates. This enables distinct visual styles like logos and colors for each tenant's authentication pages across different realms.

How does dynamic theme application work in Keycloak based on JWT claims?

Dynamic theme application based on JWT claims works by matching tenant-specific tokens to realm configurations. This allows the Keycloak authentication flow to automatically select the correct branding and design system for each user session.

Can I use my existing design system tokens in Keycloak login pages?

Yes, you can incorporate established design system tokens and components into Keycloak themes. This integration ensures brand consistency across login, account, and email pages while maintaining the visual identity of your frontend applications.

What do I need to configure for realm-specific theming in Keycloak?

Realm-specific theming in Keycloak requires configuring Keycloak realms, setting up custom theme directories, and modifying FreeMarker templates. You also need to update theme properties to apply distinct visual styles for each tenant.

Does Keycloak multi-tenant theming support SSO authentication pages?

Yes, Keycloak multi-tenant theming supports SSO authentication pages by applying realm-specific branding to login and account pages. This ensures each enterprise client's SSO portal matches their brand identity and enhances user trust.