3.2 KiB
Keycloak Admin UI
This project is the next generation of the Keycloak Administration UI. It is written with React and PatternFly 4 and uses Vite and Cypress.
Development
Prerequisites
Make sure that you have Node.js version 18 (or later) installed on your system. If you do not have Node.js installed we recommend using Node Version Manager to install it.
You can find out which version of Node.js you are using by running the following command:
node --version
In order to run the Keycloak server you will also have to install the Java Development Kit (JDK). We recommend that you use the same version of the JDK as required by the Keycloak server.
Running the Keycloak server
See the instructions in the Keycloak server app.
Running the development server
Now that the Keycloak sever is running it's time to run the development server for the Admin UI. This server is used to build the Admin UI in a manner that it can be iterated on quickly in a browser, using features such as Hot Module Replacement (HMR) and Fast Refresh.
To start the development server run the following command:
pnpm run dev
Once the process of optimization is done your browser will automatically open your local host on port 8080. From here you will be redirected to the Keycloak server to authenticate, which you can do with the default username and password (admin).
You can now start making changes to the source code, and they will be reflected in your browser.
Building as a Keycloak theme
If you want to build the application using Maven and produce a JAR that can be installed directly into Keycloak, check out the Keycloak theme documentation.
Linting
Every time you create a commit it should be automatically linted and formatted for you. It is also possible to trigger the linting manually:
pnpm run lint
Integration testing with Cypress
This repository contains integration tests developed with the Cypress framework.
Prerequisites
Ensure the Keycloak and development server are running as outlined previously in this document.
Running the tests
You can run the tests using the interactive graphical user interface using the following command:
pnpm run cy:open
Alternatively the tests can also run headless as follows:
pnpm run cy:run
For more information about the Cypress command-line interface consult the documentation.
Project Structure
You can find information about the project structure in the official Cypress documentation. Read more about how to write tests