Skip to content

Repository files navigation

Optimus UI

Optimus UI

A community-maintained, MIT licensed suite of 80+ accessible Angular UI components.

npm license angular

Documentation · Getting started · Migrating from PrimeNG · Philosophy · FAQ


Why this exists

In June 2026 PrimeTek archived the PrimeNG repository and moved future major versions, starting with v22, to a commercial license — their announcement explains why. That left a lot of applications on a library with no further open source releases.

Optimus UI is a community fork of PrimeNG v21, the last MIT licensed version, maintained by OpenNG and the community. It stays MIT. There is no paid tier and none is planned.

It is not affiliated with, endorsed by, or sponsored by PrimeTek. The philosophy page sets out what the project commits to and — just as importantly — what it does not do.

Quick start

ng add @openng/optimus-ui

The schematic asks which theme preset you want, adds the packages, wires provideOptimus into your root providers and installs everything.

import { ButtonModule } from '@openng/optimus-ui/button';
<p-button label="Check" />

Full setup, including the manual path and icons, is in the getting started guide.

Migrating from PrimeNG

Run the same command in an existing PrimeNG v21 workspace. It detects the primeng dependency and runs the migration instead of a fresh install — packages swapped, imports rewritten, then a report of anything it could not handle automatically, with file and line numbers.

ng add @openng/optimus-ui

See the migration guide for prerequisites and the manual cases. If you are on PrimeNG v20 or older, upgrade to v21 first.

Packages

Package What it is
@openng/optimus-ui The components, directives and services. The only package most applications install directly.
@openng/optimus-ui-themes Built-in theme presets — Aura, Material, Lara and Nora.
@openng/optimus-ui-styled The styled-mode theming engine that turns presets into CSS variables.
@openng/optimus-ui-styles Base styles shared by the components.
@openng/optimus-ui-tailwindcss Tailwind CSS plugin, for both v3 and v4.
@openng/optimus-ui-locale i18n locale definitions.
@openng/optimus-ui-motion Animation and transition utilities.
@openng/optimus-ui-utils Shared helpers used across the packages.

Icons live in @openng/icons and are optional — components accept any icon through templating, but the documentation examples use the pi pi-* classes.

Requirements

  • Angular v21 or newer
  • RxJS v7.8.1 or newer

Contributing

Issue triage, reproductions, pull requests and documentation fixes are all welcome — and if you had a pull request open on primefaces/primeng that never landed, CONTRIBUTING.md shows how to bring it across with its history intact.

pnpm install     # dependencies + git hooks
pnpm run dev     # run the documentation site locally

The contribution guide covers the workflow, and the roadmap covers what is planned.

Support

Community only — there is no SLA and no commercial support. Issues for bugs, Discussions for questions.

License

MIT. Forked from PrimeNG v21, which was published under the same license, with the original copyright notices intact. PrimeNG, PrimeFaces, PrimeReact, PrimeVue and PrimeFlex are trademarks of PrimeTek.

About

80+ accessible, customizable Angular components under the MIT license. A community-maintained continuation of PrimeNG v21, built to stay open.

Resources

Code of conduct

Contributing

Security policy

Stars

473 stars

Watchers

18 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages