OpenProject's Primer ViewComponents

Fork of ViewComponents for the Primer Design System used for OpenProject.

[!WARNING] As part of GitHub’s move to React-based interfaces, Primer ViewComponents is in maintenance mode as of February 2026.

Maintenance mode means:

• this project is not accepting new features, components, or significant enhancements.
• the Primer team at GitHub will continue providing:
  • Security updates
  • Dependency bumps
  • Critical/P0 bug fixes
• issues, PRs, and discussions / community Q&A remain open, but maintainer response is not guaranteed The Primer team continues to focus its resources on strategic investments that help GitHub and its customers to be successful, while making developers’ lives easier. The Primer design system remains a part of this vision through guidance, tooling, and ready-to-use React and web components.

We encourage internal GitHub consumers to plan to migrate from Primer ViewComponents to Primer React.

Non-GitHub consumers should consider forking and maintaining a copy of this repo.

Questions may be posted on the maintenance mode announcement. Thank you for your support and interest!

Contribution

Please have a look at our Contribution docs to learn about any ways to contribute as for example

• Getting started
• Adding a component
• Releasing
• Updating the fork
• ...

CI & Automation

Primer already provides us with a lot of automation and an advanced test setup. In our guide we explain how that works, and what we adapted to our need after the fork.

• CI
• Testing

Documentation

Visit https://primer.style/view_components/ to view the documentation of the Primer ViewComponents.

Note: This library is under active pre-1.0 development. Breaking changes are likely in patch releases.

License

The gem is available as open source under the terms of the MIT License.