A PrimeFaces theme to admin them all!

This project is a Primefaces admin theme based on Admin LTE and Bootstrap.

This theme is a css file containing Admin LTE and Bootstrap as well as customized Primefaces components to make them look like AdminLTE and Bootstrap.

1. Just add it to your application classpath:

   <dependency>
       <groupId>com.github.adminfaces</groupId>
       <artifactId>admin-theme</artifactId>
       <version>1.0.0</version>
   <!--<classifier>dev</classifier> uncompressed theme.css-->
   </dependency>

2. Add this context-param in your web.xml:

The theme uses less as css pre-processor. Each PrimeFaces component has its own less file:

1. Bootstrap variables and mixins are used as reference in AdminLTE and admin theme less files

2. Built in skins

3. PrimeFaces components

4. Components and Admin-LTE less files are included in theme.less

After compilation it will generate the theme.css with Admin-LTE, Bootstrap and Primefaces components.

This project uses maven classifiers to offer multiple faces (pum intended) of Admin Theme. Below is the description of each classifier and how to use it.

4.1. Default (no classifier)

<dependency>
    <groupId>com.github.adminfaces</groupId>
    <artifactId>admin-theme</artifactId>
    <version>1.0.0</version>
</dependency>

4.2. Dev classifier

<dependency>
    <groupId>com.github.adminfaces</groupId>
    <artifactId>admin-theme</artifactId>
    <version>1.0.0</version>
    <classifier>dev</classifier>
</dependency>

4.3. Without Bootstrap classifier

<dependency>
    <groupId>com.github.adminfaces</groupId>
    <artifactId>admin-theme</artifactId>
    <version>1.0.0</version>
    <classifier>without-bootstrap</classifier>
</dependency>

4.4. Without JSF classifier

<dependency>
    <groupId>com.github.adminfaces</groupId>
    <artifactId>admin-theme</artifactId>
    <version>1.0.0</version>
    <classifier>without-jsf</classifier>
</dependency>

4.5. No Fonts classifier

<dependency>
    <groupId>com.github.adminfaces</groupId>
    <artifactId>admin-theme</artifactId>
    <version>1.0.0</version>
    <classifier>no-fonts</classifier>
</dependency>

Whenever the theme is updated to a new version in the project users may have to clear their browser caches to get the changes of the new theme. Sometimes a theme update even introduces conflicts and only clearing browser cache fixes them.

To solve this issues you can use a theme classifier called no-cache:

This classifier appends the theme version to the name of theme so you need to change the theme name in web.xml:

To get your hands dirty with admin theme it is recommended to use Admin Designer in combination with Brackets or any tool that compile less files to css on save.

Using designer, which is backed by Wildfly Swarm, plus brackets will let you change the components less files and see the results instantly.

• Admin Showcase

• Admin Starter

https://adminfaces.github.io/site/docs/latest/#admin_theme

Snapshots are published to maven central on each commit, to use it just declare the repository below on your pom.xml: