6.4. Customizing the User Interface

The BRMS user interface is produced dynamically by the GWT framework. The user interface's appearance can be customized for branding or integration purposes by editing the images and CSS stylesheets.

The .css files and some of the images are found in the jboss-brms.war/org.drools.guvnor.Guvnor/ directory. (The remainder of the images are located in the images sub-directory.) To access them, the WAR file must be deployed as an exploded archive as described in the BRMS Getting Started Guide.

Edit or replace the images and CSS files and leave the filenames unchanged. If problems are encountered, restore the original versions of the files from the WAR archive.

The change most commonly undertaken is to replace the branding images, these being the logo at the top of the screen and the "site favorites" icon (hdrlogo_brms.gif and drools.gif respectively.)

The Guvnor.css controls the overall styling of the page elements.

Customize the URLs used by the BRMS Platform by editing the deployment descriptor, namely jboss-brms.war/WEB-INF/web.xml. Use the same process as for any other Java web application.