Red Hat Design System

Documentation, design tokens, and Web Components for building uniform experiences with the Red Hat brand.

🎨 For Designers

RHDS provides Figma libraries and subsystems to aid in your design work.

💻 For Developers

RHDS provides a collection of ready-made, framework-agnostic Web Components with Red Hat branding, user experience, accessibility, and style guidelines built in.

<rh-card>
  <h2 slot="heading">Red Hat Branded Web Components</h2>
  <p>So you can focus more on your content or app, and less on implementation details.</p>
  <rh-cta slot="footer">
    <a href="https://ux.redhat.com">Read the Docs</a>
  </rh-cta>
</rh-card>

LGTM Tradition

On this team, PR approvals come with a creative twist — reviewers leave a backronym for LGTM (four words starting with L, G, T, M). See lgtms.md for the full collection.

Top 10 Leaderboard

| Author | Count | |--------|-------| | @adamjohnson | 126 | | @zeroedin | 92 | | @markcaron | 68 | | @bennypowers | 34 | | @hellogreg | 30 | | @nikkimk | 15 | | @marionnegp | 10 | | @coreyvickery | 5 | | @brianferry | 3 | | @gradymcgee | 1 |

Hall of Fame

• "Looping Gizmo Throbbing Monotonously" — @markcaron
• "Legacy Garbage Tossed Mercilessly" — @adamjohnson
• "Legend Gets Toggle Mechanics" — @zeroedin
• "luxury grouped tab management" — @bennypowers
• "last growlithe tasks managed" — @hellogreg

Submodules

This repo uses a git submodule for the AI guidelines content at docs/ai-guidelines, sourced from project-felt/ai-guidelines.

Cloning: include --recurse-submodules to pull the submodule content automatically:

git clone --recurse-submodules https://github.com/RedHat-UX/red-hat-design-system.git

If you've already cloned without it, run:

git submodule update --init

Updating: to pull the latest content from the ai-guidelines repo:

cd docs/ai-guidelines
git pull origin main
cd ../..
git add docs/ai-guidelines
git commit -m "chore: update ai-guidelines submodule"

Contributions are Welcome

Would you like to contribute to the documentation or design specs? Read the site contributing guide.
Would you like to contribute to component development? Read the developer contributing guide.