The Big Picture - helixml/helix - Material UI

Material UI is a popular React UI framework developed by Google. Helix, a part of the Backstage project, provides a Material UI theme and related utilities to create a consistent look and feel for Backstage applications. In this documentation, we will explore the key concepts and components of using Material UI with Helix.

Backstage Theme

The Backstage theme is a collection of configurations, interfaces, and utilities for creating and customizing Material UI themes. It includes various color palettes, typography styles, and predefined shapes.

Interfaces

BackstageTheme

A Backstage theme.

BackstageThemeOptions

Options for creating a new Backstage theme.

UnifiedTheme

A container of one theme for multiple different Material UI versions. Currently known keys are ‘v4’ and ‘v5’.

UnifiedThemeOptions

Options for creating a new UnifiedTheme.

UnifiedThemeProviderProps

Props for UnifiedThemeProvider().

Variables

colorVariants

The color range variants that are used in e.g. colorful bursts.

darkTheme

The old Material UI v4 Backstage dark theme.

defaultComponentThemes

A helper for creating theme overrides.

lightTheme

The old Material UI v4 Backstage light theme.

pageTheme

All of the builtin page themes.

palettes

Built-in Backstage color palettes.

shapes

The default predefined burst shapes.

themes

Built-in Backstage Material UI themes.

BackstagePaletteAdditions

Backstage-specific additions to the Material UI palette.

UnifiedThemeProvider

UnifiedThemeProvider() provides themes for all Material UI versions supported by the provided unified theme.

Customizing the Look-and-Feel of Your App

To customize the look-and-feel of your Backstage application, you can use the provided theme options and components.

Component Design Guidelines

Follow these guidelines when creating new components or contributing to existing ones in Backstage.

Related Resources