This is the documentation for v7, checkout the latest version
Keycloakify
HomeGitHubStartersStorybookDiscordKeycloak-js Alternative
v7
  • Keycloakify
  • Release Notes & Upgrade Instructions
  • FAQ
v7
  • 👨‍💻Quick start
  • 🔩Keycloakify in my App
  • 📧Email customization
  • ✒️Terms and conditions
  • ✅Realtime input validation and custom registration fields
  • ⚠️Limitations
  • 🔧Environnement Variables
  • 🌎i18n: msg(...)
  • 📖Build options
  • 💂Email domain acceptlist
  • 🛑Keycloak error in log
  • 🌉Context persistence
  • 💟Contributing
  • 🤔How it works
  • ⬆️Migration guides
    • ⬆️v6 -> v7
    • ⬆️v6.x -> v6.12
    • ⬆️v5 -> v6
Powered by GitBook
On this page
  • Adding support for a new page
  • Testing your changes in the demo app (or in your project)

Was this helpful?

Contributing

Looking for submitting a PR? Thank you!

PreviousContext persistenceNextHow it works

Last updated 27 days ago

Was this helpful?

Adding support for a new page

that adds support for a page.

If you need to edit the i18n resources it should be done (and not in the src/lib/i18n/generated_kcMessages dir).

You can download the FTL/CSS source files the components are based on with the following command:

npx -p keycloakify download-builtin-keycloak-theme

Testing your changes in the demo app (or in your project)

Let's assume you have made some change to the keycloakify codebase and you want to test those changes before submitting a PR.

Assuming you have cloned keycloakify in ~/github/keycloakify this is how you would proceed.

cd ~/github # Navigate to the dir where you have the keycloakify project
git clone https://github.com/garronej/keycloakify-starter # Or your project
cd keycloakify
yarn
yarn build
yarn link-in-app keycloakify-starter
# The following command will start the compilation of Keycloakify
# in watch mode. You will be able to perform changes on the keycloakify code
# and see them apply live in the keycloakify-demo-app
npx tsc -p src/bin -w & npx tsc -p src/lib -w 

Open a new terminal window

cd ~/github
cd keycloakify-starter # Or your project
yarn start

Now you are able to test your local version of Keycloakify in the test app and make sure everything works as expected.

If you want to link your local version of keycloakify in your own app instead of the keycloakify-starter just run yarn link_in_test_app <your_app> (Assuming ../<your_app> exsist)

Heads over the development instruction if you are not already familiar with the process of testing your Keycloakify themes:

💟
Here is an example of a good PR
here
Video demo
https://github.com/keycloakify/docs.keycloakify.dev/blob/v7/broken-reference/README.md