pydawan / admin-designer

https://youtu.be/X1UEpN942s0

Admin Designer Toolkit

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

Table of Contents

• 1. What is it?
• 2. Objectives
• 3. How it works

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 Wildfly Swarm 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 wildfly-swarm:run (or mvnw.cmd wildfly-swarm: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;

   

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