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.