GitHub - primefaces/primefaces: Ultimate Component Suite for Jakarta Faces · GitHub
Skip to content

About

Ultimate Component Suite for Jakarta Faces

Resources

Code of conduct

Contributing

Stars

1.9k stars

Watchers

123 watching

Forks

Repository files navigation

Maven Continuous Integration Nightly Build Sonar License: MIT Discord Chat Stackoverflow Prime Discussions Gurubase

PrimeFaces Hero

PrimeFaces is one of the most popular UI libraries in Jakarta EE Ecosystem and widely used by software companies, world renowned brands, banks, financial institutions, insurance companies, universities and more.

License

PrimeFaces is now fully open source and maintained by the community. The project has been handed over by PrimeTek to the open-source community, and ongoing development depends on contributors and sponsors.

Development model

PrimeFaces follows a simple lifecycle:

  • Active

    • Current development branch
    • New features, improvements, and bug fixes are accepted
    • This is the main focus of contributors
  • Maintenance

    • Stable releases after feature completion
    • Only bug fixes are applied
    • No new features are introduced
  • Security

    • Older supported versions
    • Only security-related fixes and critical issues are addressed
  • EOL phase

    • Last ~6 months before End-of-Life
    • Only critical security fixes are applied
  • EOL

    • End-of-Life, no more fixes or releases

End-of-Life (EOL) policy

PrimeFaces releases a new major version roughly every ~6 months.

  • The 4 newest versions are fully supported (Active, Maintenance or Security).
  • When a new version is released, the oldest of them enters the EOL phase until the next release (~6 months).
  • During the EOL phase, only critical security fixes are applied.
  • With the next release, it reaches EOL: no more fixes or releases.

This keeps 4–5 supported version lines at any time. Release dates are estimates based on the ~6 month cycle.

Exception: 15.x is the last version supporting javax. Since many users can't move to Jakarta quickly, 15.x is an exception to this policy and stays supported longer.

See the versions table for the planned EOL dates of each version.

Community-driven development

  • PrimeFaces is now fully driven by the open-source community.
  • Development, maintenance, and issue handling are done by volunteers and contributors in their spare time.
  • Active development relies heavily on community involvement and sponsorship.

We welcome GitHub Sponsorships of active developers to support ongoing work and ensure sustainable development of new features and improvements.

If you use PrimeFaces in production, consider supporting the project through sponsorship. This helps maintain momentum across active development, maintenance, and security releases.

Feature development and bug fixes may also be sponsored. If you are interested in sponsoring a specific issue or feature, please ask directly in the relevant issue discussion.

Commercial Support

PrimeTek no longer offers PrimeFaces PRO to new customers. Commercial support is now provided by the PrimeFaces project lead through neroe.org – the alternative to PrimeFaces PRO.

  • Independent, ticket-based PrimeFaces support straight from the project lead
  • Consulting on Jakarta EE, runtimes and operations
  • Backports of fixes to older PrimeFaces versions
  • Fixes for PrimeFaces bugs go upstream, so the whole community benefits

Versions


Version Status EOL phase EOL JSF version Java version Docs Showcase
17.0.0-SNAPSHOT Active ~2029-03 ~2029-09 JSF40 - JSF40 Java HTML HTTPS
16.0.x Maintenance ~2028-09 ~2029-03 JSF40 - JSF40 Java HTML HTTPS
15.0.x Security – extended support (last javax version) JSF23 - JSF40 Java HTML HTTPS
14.0.x Security ~2028-03 ~2028-09 JSF23 - JSF40 Java HTML
13.0.x Security ~2027-09 ~2028-03 JSF20 - JSF40 Java HTML
12.0.x Security 2027-01-01 ~2027-03 JSF20 - JSF40 Java HTML
11.0.x Security 2027-01-01 ~2027-03 JSF20 - JSF40 Java HTML
10.0.x Security 2027-01-01 ~2027-03 JSF20 - JSF30 Java HTML
8.0 Security – 2027-01-01 JSF20 - JSF23 Java HTML
Archive
Version Status JSF version Java version Documentation
7.0 EOL JSF20 - JSF23 Java HTML
6.2 EOL JSF20 - JSF23 Java PDF
6.1 EOL JSF20 - JSF23 Java PDF
6.0 EOL JSF20 - JSF23 Java PDF
5.3 EOL JSF20 - JSF22 Java PDF
5.2 EOL JSF20 - JSF22 Java PDF
5.1 EOL JSF20 - JSF22 Java PDF

Maven


Release
<!-- Jakarta EE / jakarta.* / Faces 4.0+  -->	
<dependency>
    <groupId>org.primefaces</groupId>
    <artifactId>primefaces</artifactId>
    <version>16.0.0</version>
</dependency>

<!-- (Legacy / Security updates only) Java EE / javax.* / JSF 2.3 -->
<dependency>
    <groupId>org.primefaces</groupId>
    <artifactId>primefaces</artifactId>
    <version>15.0.18</version>
</dependency>
SNAPSHOT
<!-- Jakarta EE / jakarta.* / Faces 4.0+  -->
<dependency>
    <groupId>org.primefaces</groupId>
    <artifactId>primefaces</artifactId>
    <version>17.0.0-SNAPSHOT</version>
</dependency>

<repositories>
  <repository>
    <id>sonatype-snapshots</id>
    <name>Sonatype Snapshot Repository</name>
    <url>https://central.sonatype.com/repository/maven-snapshots/</url>
    <releases>
        <enabled>false</enabled>
    </releases>
    <snapshots>
        <enabled>true</enabled>
    </snapshots>
  </repository>
</repositories>

Manual Download


PrimeFaces JAR can be downloaded manually via the Maven Repository.

Tag Library


The VDL documentation for the PrimeFaces tag library can be found here: https://primefaces.github.io/primefaces/vdldoc/

Usage


<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml"
	xmlns:h="jakarta.faces.html"
	xmlns:f="jakarta.faces.core"
	xmlns:pt="jakarta.faces.passthrough"
	xmlns:jsf="jakarta.faces"
	xmlns:ui="jakarta.faces.facelets"
	xmlns:p="primefaces">

	<h:head>

	</h:head>

	<h:body>

		<p:spinner />

	</h:body>
</html>

Demo


Please refer to the showcase in order to see the full usage of the components. Sources of PrimeFaces showcase are available within module primefaces-showcase.

You can also download the PrimeFaces Showcase WAR via the Maven Repository. This is the version for plain Servlet containers like Tomcat.

Contribution


Visit the contribution page for detailed information.

Release Instructions


Visit the Release Checklist for how to release an version.

License


Licensed under the MIT License.

About

Ultimate Component Suite for Jakarta Faces

Resources

Code of conduct

Contributing

Stars

1.9k stars

Watchers

123 watching

Forks

Releases

Packages

Used by

Contributors

Languages