​

Documentation repository guidance

​

Custom SVG icons

• When adding a custom SVG through page frontmatter or a card icon property, also add a matching mask rule to style.css:
  img[src*="<icon-name>.svg"] {
    -webkit-mask-image: url("/img/<icon-name>.svg");
    mask-image: url("/img/<icon-name>.svg");
  }
  
• Without the explicit mask rule, the navigation or card icon renders as a solid square.
• Verify new icons in the local preview in the sidebar and card, including selected and dark-mode states.