A community-maintained continuation of the MIT-licensed PrimeReact v10 component library.
Documentation · npm · Releases · Issues · Discussions · Discord · Open Collective
Mantle UI is an independent, community-maintained React UI component library based on the MIT-licensed PrimeReact v10 codebase.
The project exists to provide PrimeReact v10 users with a stable, open-source path forward. Mantle UI preserves the familiar component APIs and development model while continuing maintenance, bug fixes, accessibility improvements, documentation, and compatibility work in the open.
Mantle UI is not affiliated with PrimeTek, PrimeReact, or ngrok.
- Community-driven and independently maintained
- Based on the established PrimeReact v10 codebase
- Published under the MIT License
- More than 80 React UI components
- Styled and unstyled modes
- Available on npm
- Includes an automated migration CLI
- Developed transparently on GitHub
Install Mantle UI using your preferred package manager:
npm install @mantle-ui/reactpnpm add @mantle-ui/reactyarn add @mantle-ui/reactbun add @mantle-ui/reactComponents can be imported individually:
import { Button } from '@mantle-ui/react/button';
export default function Example() {
return <Button label="Mantle UI" />;
}See the documentation for component examples, APIs, theming, and configuration.
Mantle UI includes a migration CLI that rewrites source imports from primereact to @mantle-ui/react.
The migration only updates source imports. It does not modify package.json or lockfiles.
npm install @mantle-ui/reactRun the migration in dry-run mode first:
npm exec mantleui migrate -- --dry-runnpm exec mantleui migrateThe CLI is also available with pnpm and Yarn:
pnpm exec mantleui migrate
yarn mantleui migrateYou can also run it directly without installing the package first:
npx --package @mantle-ui/react mantleui migrateTo migrate a different project directory:
npm exec mantleui migrate -- --dir ./my-appAfter running the CLI, review the generated changes and test your application before deploying them.
Mantle UI supports styled and unstyled usage.
Import a theme and the core Mantle UI stylesheet:
import '@mantle-ui/react/resources/themes/lara-light-cyan/theme.css';
import '@mantle-ui/react/resources/mantle-ui-react.css';Unstyled mode allows components to be used without the default component styling. It can be enabled globally through the Mantle UI context.
See the theming documentation for details.
Mantle UI is under active community development.
The current focus is on:
- maintaining compatibility for existing PrimeReact v10 users
- reviewing and resolving inherited issues
- fixing bugs and improving stability
- improving accessibility
- keeping the library compatible with the modern React ecosystem
- improving documentation and migration guidance
- building a sustainable contributor community
Please review the latest releases before adopting Mantle UI in production.
Before opening an issue:
- Search the existing issues.
- Confirm that the problem occurs with the latest Mantle UI release.
- Provide a minimal reproduction whenever possible.
- Include your Mantle UI, React, browser, and package-manager versions.
Use GitHub Issues for reproducible bugs and clearly defined implementation tasks.
For usage questions, ideas, feedback, and general conversation, use GitHub Discussions or join our Discord community.
Contributions are welcome.
You can help by:
- reporting and reproducing bugs
- reviewing inherited PrimeReact v10 issues
- improving documentation
- fixing accessibility problems
- submitting code changes
- testing releases
- answering community questions
Before starting substantial work, please open or join an issue so the proposed approach can be discussed.
Please read CONTRIBUTING.md for development setup, contribution guidelines, and the pull request process.
Mantle UI is developed and maintained by the community.
Financial support helps fund ongoing development, maintenance, bug fixes, accessibility improvements, documentation, infrastructure, contributor work, and community initiatives.
You can support the project through Open Collective.
Mantle UI is fiscally hosted by the Open Source Collective.
See FUNDING.md for details about funding, expenses, transparency, and sponsored development.
Mantle UI is available under the MIT License.
The project is derived from the MIT-licensed PrimeReact v10 codebase. Relevant copyright and attribution notices are preserved in accordance with the license.