keycloakify
TypeScript icon, indicating that this package has built-in type declarations

9.7.0 • Public • Published

🔏 Create Keycloak themes using React 🔏

Home - Documentation - Storybook - Starter project

This build tool generates a Keycloak theme Learn more

Keycloakify is fully compatible with Keycloak 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23 and up!

NOTE: Keycloak 24 introduces important changes.
We're actively working on incorporating them into Keycloakify. Follow progress.

Sponsor

We are exclusively sponsored by Cloud IAM, a French company offering Keycloak as a service.
Their dedicated support helps us continue the development and maintenance of this project.

Cloud IAM provides the following services:

  • Simplify and secure your Keycloak Identity and Access Management. Keycloak as a Service.
  • Custom theme building for your brand using Keycloakify.

Logo Light

Checkout Cloud-IAM and use promo code keycloakify5
5% of your annual subscription will be donated to us, and you'll get 5% off too.

Thank you, Cloud-IAM, for your support!

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Waldemar Reusch
Waldemar Reusch

💻
William Will
William Will

💻
Bystrova Ann
Bystrova Ann

💻
Michael Kreuzmayr
Michael Kreuzmayr

💻
Mary
Mary

💻
German Öö
German Öö

💻
Julien Bouquillon
Julien Bouquillon

💻
Aidan Gilmore
Aidan Gilmore

💻
Void
Void

💻
juffe
juffe

💻
Lazaros Toumanidis
Lazaros Toumanidis

💻
Marc
Marc

💻
Kasir Barati
Kasir Barati

📖
Alex Oliynyk
Alex Oliynyk

💻
Thomas Silvestre
Thomas Silvestre

💻
satanshiro
satanshiro

💻
Koen Poelhekke
Koen Poelhekke

💻
Sergey Kupletsky
Sergey Kupletsky

⚠️ 💻
rome-user
rome-user

💻
Céline Pelletier
Céline Pelletier

💻
Garth
Garth

💻
Felix Gustavsson
Felix Gustavsson

💻
Markus Siemens
Markus Siemens

💻
Rlok
Rlok

💻
Moulyy
Moulyy

💻
giorgoslytos
giorgoslytos

💻

Changelog highlights

9.5

  • Post build hook: You can now apply custom transformation to your theme files. Learn more.
  • You can now specify your option in the Keycloakify's Vite plugin instead in the package.json. See example.

9.4

Vite Support! 🎉

9.0

Bring back support for account themes in Keycloak v23 and up! See issue.

Breaking changes

Very few. Check them out here.

8.0

  • Much smaller .jar size. 70.2 MB -> 7.8 MB.
    Keycloakify now detects which of the static resources from the default theme are actually used by your theme and only include those in the .jar.
  • Build time: The first build is slowed but the subsequent build are faster. Update your CI so that the cache is persisted across CI build.

Breaking changes

There are very few breaking changes in this major version. Check them out.

7.15

  • The i18n messages you defines in your theme are now also maid available to Keycloak. In practice this mean that you can now customize the kcContext.message.summary that display a general alert and the values returned by kcContext.messagesPerField.get() that are used to display specific error on some field of the form. See video

7.14

  • Deprecate the extraPages build option. Keycloakify is now able to analyze your code to detect extra pages.

7.13

7.12

  • You can now pack multiple themes variant in a single .jar bundle. In vanilla Keycloak themes you have the ability to extend a base theme. There is now an idiomatic way of achieving the same result. Learn more.

7.9

  • Separate script for copying the default theme static assets to the public directory.
    Theses assets are only needed for testing your theme locally in Storybook or with a mockPageId.
    You are now expected to have a "prepare": "copy-keycloak-resources-to-public", in your package.json scripts.
    This script will create public/keycloak-assets when you run yarn install (If you are using another package manager like pnpm makes sure that "prepare" is actually ran.)
    See the updated starter. public/keycloak-assets shouldn't be tracked by GIT and is automatically ignored.

7.7

7.0 🍾

  • Account theme support 🚀
  • It's much easier to customize pages at the CSS level, you can now see in the browser dev tool the customizable classes.
  • New interactive CLI tool npx eject-keycloak-page, that enables to select the page you want to customize at the component level.
  • There is a Storybook
  • Remember me is fixed

6.13

  • Build work behind corporate proxies, see issue.

6.12

Massive improvement in the developer experience:

6.11.4

  • You no longer need to have Maven installed to build the theme. Thanks to @lordvlad, see PR.
  • Feature new build options: bundler, groupId, artifactId, version.
    Theses options can be user to customize the output name of the .jar. You can use environnement variables to overrides the values read in the package.json. Thanks to @lordvlad.

6.10.0

  • Widows compat (thanks to @lordvlad, see PR). WSL is no longer required 🎉

6.8.4

  • @emotion/react is no longer a peer dependency of Keycloakify.

6.8.0

  • It is now possible to pass a custom <Template /> component as a prop to <KcApp /> and every individual page (<Login />, <RegisterUserProfile />, ...) it enables to customize only the header and footer for example without having to switch to a full-component level customization. See issue.

6.7.0

  • Add support for webauthn-authenticate.ftl thanks to @mstrodl's hacktoberfest PR.

6.6.0

  • Add support for login-password.ftl thanks to @mstrodl's hacktoberfest PR.

6.5.0

  • Add support for login-username.ftl thanks to @mstrodl's hacktoberfest PR.

6.4.0

  • You can now optionally pass a doFetchDefaultThemeResources: boolean prop to every page component and the default <KcApp /> This enables you to prevent the default CSS and JS that comes with the builtin Keycloak theme to be downloaded.
    You'll get a black slate.

6.0.0

  • Bundle size drastically reduced, locals and component dynamically loaded.
  • First print much quicker, use of React.lazy() everywhere.
  • Real i18n API.
  • Actual documentation for build options.

Checkout the migration guide

5.8.0

5.7.0

  • Feat logout-confirm.ftl. PR

5.6.4

Fix login-verify-email.ftl page. Before - After

5.6.0

Add support for login-config-totp.ftl page #127.

5.3.0

Rename keycloak_theme_email to keycloak_email.
If you already had a keycloak_theme_email you should rename it keycloak_email.

5.0.0

Migration guide
New i18n system.
Import of terms and services have changed. See example.

4.10.0

Add login-idp-link-email.ftl page See PR.

4.8.0

Email template customization.

4.7.4

M1 Mac support (for testing locally with a dockerized Keycloak).

4.7.2

WARNING: This is broken.
Testing with local Keycloak container working with M1 Mac. Thanks to @eduardosanzb.
Be aware: When running M1s you are testing with Keycloak v15 else the local container spun will be a Keycloak v16.1.0.

4.7.0

Register with user profile enabled: Out of the box options validator support.
Example

4.6.0

tss-react and powerhooks are no longer peer dependencies of keycloakify. After updating Keycloakify you can remove tss-react and powerhooks from your dependencies if you don't use them explicitly.

4.5.3

There is a new recommended way to setup highly customized theme. See here.
Unlike with the previous recommended method, with this new method your theme wont break on minor Keycloakify update.

4.3.0

Feature login-update-password.ftl.
Every time a page is added it's a breaking change for non CSS-only theme.
Change this and this to update.

4

  • Out of the box frontend form validation 🥳
  • Improvements (and breaking changes in import { useKcMessage } from "keycloakify".

3

No breaking changes except that @emotion/react, tss-react and powerhooks are now peerDependencies instead of being just dependencies.
It's important to avoid problem when using keycloakify alongside mui and when passing params from the app to the login page.

2.5

2

  • It's now possible to implement custom .ftl pages.
  • Support for Keycloak plugins that introduce non standard ftl values. (Like for example this plugin that define authorizedMailDomains in register.ftl).

Package Sidebar

Install

npm i keycloakify

Weekly Downloads

15,655

Version

9.7.0

License

MIT

Unpacked Size

4.81 MB

Total Files

821

Last publish

Collaborators

  • garronej