Contributing

Adding support for a new page

Here is an example of a good PR that adds support for a page.

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

The keycloakify components are a plain React translation of the default theme that comes with Keycloak v11.0.3.

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

npx -p keycloakify download-builtin-keycloak-theme

then select version 11.0.3 (Video demo).

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-demo-app
cd keycloakify
yarn 
yarn build
yarn link_in_test_app
npx tsc -w #This 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

Open a new terminal window

cd ~/github
cd keycloakify-demo-app
yarn start

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

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