🚀 Keycloakify v10 starter 🚀

This starter is based on Webpack. There is also a Vite based starter.

git clone https://github.com/keycloakify/keycloakify-starter-webpack
cd keycloakify-starter-webpack
yarn install # Or use pnpm or bun (but not npm), just be sure to delete the yarn.lock if you do.

Documentation

Documentation

You need to have Maven installed to build the theme (The mvn command must be in the PATH).

• On macOS: brew install maven
• On Debian/Ubuntu: sudo apt-get install maven
• On Windows: choco install openjdk and choco install maven (Or download from here)

npm run build-keycloak-theme

Note that by default Keycloakify generates multiple .jar files for different versions of Keycloak.
You can customize this behavior, see documentation here.

The starter comes with a generic GitHub Actions workflow that builds the theme and publishes the jars as GitHub releases artifacts.
To release a new version just update the package.json version and push.

To enable the workflow go to your fork of this repository on GitHub then navigate to: Settings > Actions > Workflow permissions, select Read and write permissions.

This setup is based on Create React App however you can eject it into a custom Webpack setup with:

npx react-scripts eject