Preview and Validate Admin Themes
Check light mode, dark mode, contrast, component states, and dense admin pages before applying a theme.
Use preview before saving or applying theme changes.
Before you begin
You need unsaved or selected theme changes ready to inspect.
Plan to check both light and dark mode. Do not approve a theme based only on one screen or one component type.
Open preview
Select Preview from the admin theme header to open a side sheet.
The preview includes light and dark mode toggles and sample admin and product surfaces such as course cards, metric cards, buttons, forms, navigation tabs, user table rows, badges, progress, and alerts.
Use preview to check whether the theme still works across common component states, not only on the page you are editing.
Check readability
Review:
- Dense tables.
- Buttons and disabled states.
- Form fields.
- Sidebar contrast.
- Status badges and alerts.
- Chart color separation.
- Long labels and wrapped text.
If a badge or warning says the contrast ratio fails WCAG AA, change either the background token or the foreground token until it passes.
Verify success
The theme is ready to apply when:
- Light and dark mode both pass readability checks.
- Important text and control contrast pairs pass.
- Fonts do not create unexpected wrapping.
- Spacing, radius, and shadow choices still support scanning.
Troubleshooting
Check a dense admin page, such as a user table or report table, before applying the theme broadly.
Adjust chart tokens in the dark palette instead of relying only on the light palette values.