Skip to content
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.


Admin Designer Toolkit

The aim of this application is to make it easier to customize Admin theme and Admin Template.

1. What is it?

This the same Admin Showcase application with admin template and admin theme bundled inside instead of being project dependencies.

It uses ThornTail to run the exploded application so one can change the theme or template and see the modifications without needing to restart the application.  

2. Objectives

The initial idea was to speed AdminFaces development but it turns out that it can easy contributions from non Java developers (like designers and frontend developers) as the project is about front end components and layout.

Also another great feature of Admin Designer is the possibility to download the customized project as a maven project.


The downloaded project is the Admin Starter with modified admin theme and template embedded in the project.

This is the most flexible approach but at the same time you lose the updates on Admin Theme and template projects because you don’t depend on them anymore.

3. How it works

  1. First download Admin Designer from github releases here;

  2. Now in application root directory start it by running the command:

    ./mvnw thorntail:run (or mvnw.cmd thorntail:run) (1)
    1. To use mvnw (maven wrapper) you just need Java installed (JAVA_HOME pointing to a JDK).

  3. Edit any less file in directory src/main/resources/less.

  4. Now to compile the application using:

     ./mvnw compile (or mvnw.cmd compile)
    If you don’t want to compile every time you change a less file, use the flag Or use a tool like brackets with less extension installed.
  5. Finally when you’re done you can download the customized theme or template packed as jar files or even download it as a zipped maven project;


The changes made to less files should be visible in running application http://localhost:8080/showcase

There is no need to stop and run the application again.

You can see this workflow in the following video:

You can’t perform that action at this time.