Skip to content
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.mvn/wrapper
src/main
.gitignore
README.adoc
designer.png
faces-config.NavData
mvnw
mvnw.cmd
pom.xml
run.cmd
run.sh

README.adoc

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 -Dlesscss.watch=true. 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;

    designer

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: https://youtu.be/X1UEpN942s0

You can’t perform that action at this time.