| .github/workflows | ||
| .storybook | ||
| public | ||
| src | ||
| .eslintrc.cjs | ||
| .gitignore | ||
| .prettierignore | ||
| .prettierrc.json | ||
| index.html | ||
| LICENSE | ||
| package.json | ||
| README.md | ||
| tsconfig.json | ||
| tsconfig.node.json | ||
| vite.config.ts | ||
| yarn.lock | ||
🚀 Keycloakify v10 starter 🚀
This starter is based on Vite. There is also a Webpack based starter.
Quick start
git clone https://github.com/keycloakify/keycloakify-starter
cd keycloakify-starter
yarn install # Or use an other package manager, just be sure to delete the yarn.lock if you do.
Testing the theme locally
How to customize the theme
Building the theme
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 openjdkandchoco 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.
Initializing the account theme
npx keycloakify initialize-account-theme
Initializing the email theme
npx keycloakify initialize-email-theme
GitHub Actions
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.