UI Themes Troubleshooting

Fix the most common theme issues quickly.

Theme Not Loading

  • Validate JSON syntax (trailing commas and quotes are common failures).
  • Ensure folder includes theme.json.
  • Check unique id value and valid file encoding (UTF-8).

Styles Still Default

  • Verify token name matches exactly (case-sensitive).
  • If a property is hardcoded in CSS and not tokenized, use cssRules override.
  • Reload theme selection after edits.

Logo Not Appearing

  • Confirm logo.png exists in same folder as theme.json.
  • Use PNG and avoid oversized images.
  • If invalid, default logo fallback is expected.