remove d15 references for now

productNameFull → productName

.drone.yml

@@ -0,0 +1,19 @@
+---
+kind: pipeline
+name: deploy to autonomic-ruangrupa
+steps:
+  - name: deploy new theme
+    image: 3wordchant/docker-cp-deploy:latest
+    settings:
+      host: lumbung.space
+      service: login_lumbung_space_app
+      source: lumbung.space
+      dest: /opt/keycloak/themes
+      deploy_key:
+        from_secret: drone_ssh_lumbung.space
+trigger:
+  branch:
+    - main
+  event:
+    exclude:
+      - pull_request

README.md

@@ -1,5 +1,40 @@
 # login.lumbung.space
 
+[![Build Status](https://drone.autonomic.zone/api/badges/ruangrupa/login.lumbung.space/status.svg?ref=refs/heads/main)](https://drone.autonomic.zone/ruangrupa/login.lumbung.space)
+
 > [login.lumbung.space](https://login.lumbung.space)
 
 [Custom theming](https://www.keycloak.org/docs/latest/server_development/index.html#_themes) for the Keycloak SSO service.
+
+Please see [default-themes/README.md](./default-themes/README.md) and [lumbung.space/README.md](./lumbung.space/README.md) for more info.
+
+## Deployment
+
+Just send commits and the [Drone CI/CD configuration](./.drone.yml) will take care of the rest.
+
+## Custom theming workflow
+
+You'll need a local [Docker](https://docs.docker.com/engine/install/debian/) installation.
+
+Then run a local Keycloak instance and mount the theme into the container with the following ([makefile source](./makefile)):
+
+```
+$ make
+```
+
+An example workflow for customising the login theme would be:
+
+- Log into [localhost:8080](http://localhost:8080) with username: `admin` and password: `admin`
+- Go to [Realm Settings > Themes](http://localhost:8080/auth/admin/master/console/#/realms/master/theme-settings)
+- 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](./lumbung.space/login/messages/messages_en.properties)
+- Reload the page, your change should be live
+
+See related documentation and tutorials for the hacking:
+
+- [Create a custom theme for Keycloak](https://auscunningham.medium.com/create-a-custom-theme-for-keycloak-8781207be604)
+- [Change Login Theme in Keycloak Docker image](https://austincunningham.ddns.net/2020/changekeycloakdockertheme)
+- [Keycloak themes documentation](https://www.keycloak.org/docs/latest/server_development/index.html#_themes)
+- [Keycloak Github repo for default themes](https://github.com/keycloak/keycloak/tree/master/themes/src/main/resources/theme)
+- [Keycloak container documentation](https://github.com/keycloak/keycloak-containers/tree/master/server)

bin/disable-theme-cache.cli

@@ -0,0 +1,5 @@
+embed-server --std-out=echo --server-config=standalone-ha.xml
+/subsystem=keycloak-server/theme=defaults/:write-attribute(name=cacheThemes,value=false)
+/subsystem=keycloak-server/theme=defaults/:write-attribute(name=cacheTemplates,value=false)
+/subsystem=keycloak-server/theme=defaults/:write-attribute(name=staticMaxAge,value=-1)
+stop-embedded-server

default-themes/README.md

@@ -0,0 +1,3 @@
+# default-themes
+
+The keycloak documentation says that it is not recommended to modify existing themes. Therefore, we include these files here as a copy/pasta of [those existing themes in the Keycloak github repository](https://github.com/keycloak/keycloak/tree/master/themes/src/main/resources/theme) for the purpose of copying over to a custom theme. If you want to make theme changes, please make them in the [lumbung.space](../lumbung.space) folder.