Themes
Last updated
Was this helpful?
Last updated
Was this helpful?
With themes, you can define a custom color palette, default border radius, button and input variants, tooltip size and color, and typography settings to be applied across an app. A default theme is applied to new apps, but you can change the theme in or on app creation if you already have the theme defined.
As you edit a theme, example components will be rendered on the right-hand side of theme editor. Individual components can be customized within the , but some general settings such as available colors and font families must be declared within a theme.
To change a color, click the existing color in the theme editor and either:
Select an option from the Material Palette
Use the Color Picker to define a custom color.
With the color picker, you can also enter hex, RGB, and opacity values directly. Click the hex or rgb label to switch between the two.
With the exception of Primary and Secondary colors, you can also enter hex and opacity values directly into the input field.
By default, a theme is set to be a Light Theme. This means your app will have white or light-colored backgrounds and dark text. Alternatively, you can set a theme to be a Dark Theme, often known as dark mode. With a dark theme, your app will have black or dark-colored backgrounds and white or light-colored text.
Set the palette with your audience and primary use cases in mind. Dark palettes are more popular for mobile apps and night-time use, while they are rarely used for corporate solutions. When in doubt, choose a light theme.
Under Color palette, you can define the primary and secondary colors for your theme. These are the colors that you want to feature most prominently in your app and are available everywhere you can adjust the color in your UI. In a typical app, the primary color will be used for the main user interface elements and the secondary color as an accent color where required. For both of these colors, a lighter and darker version is automatically generated.
You can choose to override the contrast text color for the primary and secondary colors. Contrast colors are used when the the main colors are used as solid backgrounds, for example in the App Bar or as buttons. The theme will apply sensible defaults, and ensure that dark text is used on light backgrounds and vice versa.
If you need additional colors available throughout your UI, you can add those under Custom colors. When you add a custom color, you should set a sensible key (name).
Important
If a color key is changed, any reference to that color from an app will be lost.
Text colors are automatically assigned based on the context in the UI, and can also be assigned directly to some components.
The primary color for body text.
A secondary color for body text and also used to style to input fields.
Used to style input field labels and values when the component is disabled.
Action colors are applied to UI components either manually or automatically depending on their state.
This color can can be manually applied to Icon buttons (Button Color: Default
) and Icons (Icon Color: Action
).
Applied to Buttons when disabled.
State colors are used to consistently represent messages of various severity within your app. These colors are available within the color picker when styling UI components.
Typically used to provide general information in the context of a user action.
Typically used to indicate a user or automated action was successfully completed.
Typically used to indicate that there are consequences to be aware of before performing an action or that non-critical functionality has failed.
Typically used to indicate invalid data or that critical functionality has failed.
This color is used to highlight an input field and for any helper text if the Error property for that component equates to true
.
Override the default link text color.
This Theme Border Radius sets the border radius in pixels for relevant UI components, such as Text Inputs and Buttons.
By default, buttons will inherit the border radius from the Theme Border Radius. You may override this border radius by ticking Override Border Radius.
Select the default variant (Text
, Outlined
, Contained
) for Buttons added to your UI.
Visible when Override Border Radius is selected. Select the number of pixels to be applied as border radius for all buttons.
Remove elevation from buttons with variant Contained
.
Select the default variant (Text
, Outlined
, Contained
) for Inputs (Text Input
, Date and Time Picker
, Select
etc) added to your UI.
By default, Popovers will inherit the border radius from the Theme Border Radius. You may override this border radius by ticking Border Radius Override.
Select whether arrows should be visible on tooltips.
By default, Tooltips will inherit the border radius from the Theme Border Radius. You may override this border radius by ticking Border Radius Override.
Change the default font size for all tooltips. The default font size is 11px.
Change the background color for tooltips.
Change the text color for tooltips.
To add a new font family to your Theme:
Click the + icon to open the Add Theme Font dialog.
Select a font family from either the Featured, Google Fonts, or Custom Fonts tabs. A sample will be displayed along with a list of the styles available.
Select the styles required for your app(s). These can be adjusted later.
Click Add Font.
Each theme has a default font family that is applied to UI components. This font family is marked with a star icon. To select a new default font family:
Click the font family in the list of font families added to the theme.
Click the star icon in the top-right of the popover.
To replace one font family with another:
Click the font family in the list of font families added to the theme.
Click the left/right arrows icon in the top-right of the popover.
Select a font family and the styles required.
Click Replace Font.
H1–H6
Subtitle1
Subtitle2
Body2 (Container loader messages)
Button (Button components)
Caption (Input helper text)
Overline
Each variant has the following properties which can all be customized.
Font Family
Font Color
The color and opacity of the font.
Font Size
The size of the font, in pixels. This value is converted to rem in the Appfarm Client.
Font Weight
The weight (boldness) of the font. The options are restricted to the styles added for the selected font family.
Line Height
The distance between lines of text. This value is unitless and the line height is calculated by multiplying this number by the element's font size.
Letter Spacing
The horizontal spacing between text characters, in pixels.
Uppercase
Convert all characters to uppercase.
Note that when applying a color to a UI component using the , an additional set of nine shades of grey is available. These are not customizable.
The background color applied to new .
An alternative background color often used for to provide contrast to the default background.
Automatically applied as the background color of a row in a or an item in a on hover. Note that hover must be enabled on the component.
Automatically applied as the background color of an item in a when selected. Note that selection must be enabled on the component.
Automatically applied to Buttons, Icon buttons, and checkboxes when disabled.
The divider color is applied to dividers enabled within UI components such as . You can also use it as a border color when setting up custom borders.
For some UI Components, such as the Container, this value serves as a default that can be applied to the UI Components by selecting the Use Border Radius from Theme checkbox in .
Add and manage fonts from Google Fonts or your own custom fonts. Custom fonts must first be .
There is a pre-defined array of typography variants configured. These variants are applied automatically to some UI components while you can also apply a variant manually, such as on the . The variants, with some of their default applications in parentheses, are:
Body1 ( components)
The .