Apache MyFaces Tobago is a JSF component framework that pays special attention to security and is optimized for business applications.
Tobago supports custom themes based on the popular Bootstrap framework and frees the user from having to develop complex CSS and Javascript components.
Compared to many other JSF frameworks, Tobago is still being actively developed and is used in many projects.
Git, Maven 3 and at least JDK8.
In the project directory you can use:
mvn clean install
to run the install target on all sub projects. This will put all necessary artifacts into your local repository.
You can find a live demo of all components at https://tobago-vm.apache.org/
See tobago-examples
directory for some simple examples on how to use Tobago.
Demo
If you want to run the demo locally you need to run the following command
mvn -f tobago-example/tobago-example-demo/pom.xml clean package tomee:run -Ptomee -Pdev
- Mode 1: old | compatible | classic | useShowAttributes
- Mode 2: auto
- Mode 3: custom
Browse to the local URL http://localhost:8080/
You can also run the demo with different servers and JSF implementations
Jetty, MyFaces and Weld
mvn -f tobago-example/tobago-example-demo/pom.xml clean package jetty:run -Pjetty -Pdev
Jetty, Mojarra and Weld
mvn -f tobago-example/tobago-example-demo/pom.xml clean package jetty:run -Pjetty -Pdev -Djsf=mojarra-4.0
Tomcat
mvn -f tobago-example/tobago-example-demo/pom.xml package -Ptomcat cargo:run
TomEE (currently broken)
mvn -f tobago-example/tobago-example-demo/pom.xml clean package -Ptomee tomee:run
Open Liberty
mvn -f tobago-example/tobago-example-demo/pom.xml clean -Pliberty liberty:run
Browse to the local URL http://localhost:9080/
Tomcat in Docker
mvn -f tobago-example/tobago-example-demo/pom.xml clean package -Pdocker
docker run -p 8080:8080 myfaces/tobago-example-demo:latest
Browse to the local URL http://localhost:8080/
If you find any issues regarding MyFaces Tobago you can use the Apache Issue Tracker to report them
Pull requests are welcome; see the contributor guidelines for details.
The terms for software licensing are detailed in the LICENSE.txt file.