Skip to content

apache/myfaces-tobago

Repository files navigation

License Tobago CI CodeQL Build Status ASF

Apache Tobago

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.

Table of Contents

Getting Started

Prerequisites

Git, Maven 3 and at least JDK8.

Building

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.

Live Demo

You can find a live demo of all components at https://tobago-vm.apache.org/

Examples

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/

Issue Tracking

If you find any issues regarding MyFaces Tobago you can use the Apache Issue Tracker to report them

Contributing

Pull requests are welcome; see the contributor guidelines for details.

Licensing

The terms for software licensing are detailed in the LICENSE.txt file.