Continuing PrimeReact v10: Introducing Mantle UI

Sven Jansen — Mon, 27 Jul 2026 11:21:37 +0000

When the original PrimeReact repository was archived, many teams using PrimeReact v10 were left with an uncertain path forward.

The existing MIT-licensed code remained available, but active open-source development had effectively stopped. Applications built on PrimeReact v10 still needed bug fixes, accessibility improvements, documentation updates, and compatibility with the evolving React ecosystem.

That is why we started Mantle UI.

What is Mantle UI?

Mantle UI is an independent, community-maintained continuation of the MIT-licensed PrimeReact v10 codebase.

The goal is not to create an unrelated component library from scratch. Mantle UI exists to provide existing PrimeReact v10 users with a practical and sustainable open-source path forward.

The project preserves the familiar APIs, components, theming concepts, and development model while continuing maintenance in the open.

Mantle UI is not affiliated with PrimeTek, PrimeReact, or ngrok.

Why continue PrimeReact v10?

PrimeReact v10 is used in many existing applications. Replacing an entire UI component library is rarely a small task.

Teams may depend on:

component APIs and behavior
existing themes and styles
accessibility behavior
custom passthrough configuration
application-specific wrappers
years of accumulated implementation knowledge

For these projects, migrating to a completely different library can be expensive and risky.

Mantle UI aims to reduce that risk by continuing from the established PrimeReact v10 foundation.

Available on npm

Mantle UI is already published on npm as @mantle-ui/react.

Install it with:

npm install @mantle-ui/react

It is also available through other package managers:

pnpm add @mantle-ui/react
yarn add @mantle-ui/react
bun add @mantle-ui/react

Components can be imported individually:

import { Button } from '@mantle-ui/react/button';

export default function Example() {
    return <Button label="Mantle UI" />;
}

Migrating from PrimeReact

Mantle UI includes a migration CLI that rewrites source imports from primereact to @mantle-ui/react.

After installing Mantle UI, preview the migration first:

npm exec mantleui migrate -- --dry-run

Apply the migration with:

npm exec mantleui migrate

The CLI is also available with pnpm and Yarn:

pnpm exec mantleui migrate
yarn mantleui migrate

It can also be run directly from the published package without installing it first:

npx --package @mantle-ui/react mantleui migrate

The migration updates source imports only. It does not modify package.json or lockfiles.

You should always review the generated changes and test your application before deploying them.

What has been done so far?

Mantle UI has already published multiple releases.

Recent improvements include:

improved keyboard navigation in MultiSelect
an accessible name for ListBox
support for ReactNode tooltip content
restored negative input support in InputNumber
improved AutoComplete support inside IconField
preserved Tailwind classes in passthrough configuration
corrected Calendar navigation across overlay rows
fixes for documentation examples and API documentation
package version metadata for subpackages
removal of remaining PrimeReact and PrimeTek branding
automated npm publishing and release infrastructure

Several of these changes resolve issues inherited from the PrimeReact v10 backlog.

The project is therefore not only preserving the old codebase. It is actively fixing and improving it.

Current priorities

Our current focus includes:

maintaining compatibility for existing PrimeReact v10 users
reviewing and resolving inherited issues
fixing long-standing bugs
improving accessibility
keeping the library compatible with the modern React ecosystem
improving documentation and migration guidance
building a sustainable contributor community

Community-driven development

Mantle UI is developed openly on GitHub.

Users can report bugs, propose improvements, ask questions, and contribute changes. Technical decisions are made in the interest of the project and its community rather than being tied to the roadmap of a single company.

Financial contributions do not provide control over the project roadmap, governance, licensing, or technical direction.

Funding and sustainability

Mantle UI is available through Open Collective and is fiscally hosted by the Open Source Collective.

Funding may support:

ongoing development and maintenance
bug fixes
accessibility improvements
documentation
infrastructure and hosting
contributor work
community initiatives

Project contributions and expenses are managed transparently through Open Collective.

We would value your feedback

We are especially interested in hearing from teams that still use PrimeReact v10.

Useful feedback includes:

whether the migration CLI works correctly in your project
compatibility issues you encounter
inherited bugs that are still relevant
accessibility problems
missing documentation
components or workflows that need particular attention

You can try the migration without changing any files:

npx --package @mantle-ui/react mantleui migrate --dry-run

Mantle UI is still at the beginning of its journey, but the foundation is available today, releases are being published, and development is continuing in the open.

DEV Community: Sven Jansen