Skip to content

ncasnap/keycloakify

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ” Create Keycloak themes using React πŸ”

Home - Documentation - Starter project

Ultimately this build tool generates a Keycloak theme Learn more

πŸ—£ V6 have been released πŸŽ‰
It features major improvements.
Checkout the migration guide.

Changelog highlights

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

v5.6.0

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

v5.3.0

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

v5.0.0

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

v4.10.0

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

v4.8.0

Email template customization.

v4.7.4

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

v4.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.

v4.7.0

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

v4.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.

v4.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.

v4.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.

v4

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

v3

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.

v2.5

v2

  • 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).

About

πŸ” Create Keycloak themes using React

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 99.3%
  • Other 0.7%