Apache MyFaces Tobago

Clone this repo:
  1. 75c4b06 feature(popup): rename "staticBackdrop" to "modal" by Henning Noeth · 12 days ago main
  2. 91f7df2 refactor(demo): static backdrop attribute by Henning Noeth · 2 weeks ago
  3. 4192528 build(theme): rebuild after implementing staticBackdrop for popup component by Henning Noeth · 2 weeks ago
  4. 930d2e7 feature(popup): static backdrop attribute by Henning Noeth · 4 weeks ago
  5. d8be77b ci(dependabot): ignore deltaspike 2.0.0 by Henning Noeth · 3 weeks ago

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

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

Jetty, Mojarra and Weld

mvn -f tobago-example/tobago-example-demo/pom.xml clean package jetty:run -Pjetty -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.