RHDH / Red Hat Developer Hub Theme 🎨
A set of theming options for MUI Material UI and Backstage that look more similar to PatternFly.
It also includes a Storybook and a Storybook test-runner for automatic visual regression tests.
Returns all testable themes (incl. the backstage default color scheme and older RHDH versions):
getAllThemes: () => AppTheme[]
useAllThemes: () => AppTheme[]
Returns the latest, not released RHDH light and dark theme for your backstage/RHDH instance:
getThemes: () => AppTheme[]
useThemes: () => AppTheme[]
useLoaderTheme: () => MUIv5.Theme
npm install @redhat-developer/red-hat-developer-hub-theme
or
yarn add @redhat-developer/red-hat-developer-hub-theme
Starting with 1.2 this library is shipped with your RHDH installation.
On older RHDH instances you can install it:
-
Install the dependency with
yarn workspace app add @redhat-developer/red-hat-developer-hub-theme
-
In
packages/app/src/components/DynamicRoot/DynamicRoot.tsx
import { useThemes } from '@redhat-developer/red-hat-developer-hub-theme'; // ... const themes = useThemes(); // ... app.current = createApp({ apis: [...staticApis, ...remoteApis], // ... remove defaultThemes from here: themes, components: defaultAppComponents, });
-
Install the dependency with
yarn workspace app add @redhat-developer/red-hat-developer-hub-theme
-
Update
packages/app/src/App.tsx
and apply the themes tocreateApp
:import { getThemes } from '@redhat-developer/red-hat-developer-hub-theme'; // ... const app = createApp({ apis, // ... themes: getThemes(),
-
Install the dependency with
yarn workspace <plugin-root or plugin-name> add @redhat-developer/red-hat-developer-hub-theme
-
Add to your
*/dev/index.tsx
:import { getAllThemes } from '@redhat-developer/red-hat-developer-hub-theme'; // ... createDevApp() .registerPlugin(...) .addThemes(getAllThemes()) .addPage({ // ... }) .render();
-
Clone the rhdh theme and run
npm link
in it:cd red-hat-developer-hub-theme yarn link
-
To use this link you can cd any other repository:
cd ../backstage-plugins yarn link @redhat-developer/red-hat-developer-hub-theme
- Backstage
- PatternFly
- MUI v4:
- MUI v5