login.lumbung.space/README.md
decentral1se 0296bd97d6
All checks were successful
continuous-integration/drone/push Build is passing
Make the title more specific
2021-05-24 12:53:30 +02:00

2.3 KiB

login.lumbung.space

Build Status

login.lumbung.space

Custom theming for the Keycloak SSO service.

Please see default-themes/README.md and lumbung.space/README.md for more info.

Deployment

Just send commits and the Drone CI/CD configuration will take care of the rest.

Custom theming workflow

You'll need a local Docker installation.

Then run a local Keycloak instance and mount the theme into the container with the following (makefile source):

$ make

An example workflow for customising the login theme would be:

  • Log into localhost:8080 with username: admin and password: admin
  • Go to Realm Settings > Themes
  • Choose a custom login theme via Login Theme > lumbung.space and click Save
  • Sign out and you'll be redirected to the login page
  • Now, test you can make an edit and it is reflected on reload, change the "Username or email" string in mesages_en.properties
  • Reload the page, your change should be live

Once you're finished theming, git push and the Drone CI config will deploy this live to login.lumbung.space.

See related documentation and tutorials for the hacking: