โ ๏ธLimitations
Some pages still have the default theme. Why?
This project only support out of the box the most common user facing pages of Keycloak login.
To see the complete list of pages that Keycloak provide you can download the base theme with the following command
npx -p keycloakify download-builtin-keycloak-theme
Most Keycloakify component are based on the base theme of Keycloak v11.0.3 (Video demo).
Here are the pages currently implemented by this module.
I have established that a page that I need isn't supported out of the box by Keycloakify, now what?
process.env.PUBLIC_URL
not supported.
process.env.PUBLIC_URL
not supported.You won't be able to import things from your public directory in your JavaScript code (it's supported in public/index.html
). (This isn't recommended anyway).
@font-face
importing fonts from the src/
dir
@font-face
importing fonts from the src/
dirIf you are building the theme with --external-assets this limitation doesn't apply, you can import fonts however you see fit.
Example of setup that won't work
We have a
fonts/
directory insrc/
We import the font like this
src: url("/fonts/my-font.woff2") format("woff2");
in a.scss
a file.
Possible workarounds
If it is possible, use Google Fonts or any other font provider.
If you can't or wont move your
@font-face
statements in thepublic/index.html
, you can still use non relative url, you will need to enableAccess-Control-Allow-Origin
for your font files, even on the same domain.
login and email only
As of now Keycloakify only enable you to create a theme that covers the Login pages and the emails. Acount
and Admin Console
aren't supported yet.
If you are missing this feature open an issue about it.
Last updated