Add Icon

• title: Display name used in the SVG title tag.
• slug: Lowercase, URL-safe identifier (no spaces).
• hex: Brand color hex without # (uppercase preferred).
• source: Source URL for the icon (empty string if unavailable).
• guidelines: Brand guidelines URL (empty string if unavailable).
• path: SVG path data string (single path, viewBox 0 0 24 24).
• svg: Getter that returns a Simple Icons-compatible <svg> string, using title and path.

2. Add the mapping entry

Update common/icons/languageMapping.ts:

• Import the Simple Icon or custom icon.
• Add the entry in LANGUAGE_ICON_MAPPING under “GitHub Linguist languages” (for languages) or “Custom Frameworks, Libraries, Tools and Platforms” (for non-languages), keeping alphabetical order by display name.

3. Check UI coverage

Confirm the UI can surface the new entry:

• common/configHelper.ts uses LANGUAGE_ICON_MAPPING to build language options, so additions there should show in dropdowns automatically.

4. Update docs and changeset

Follow repo conventions:

• Add a changeset via pnpm changeset add --empty, then fill in a one-line description.
• Update AGENTS.md or other relevant docs if the supported list is referenced.

Implementation checklist

• Choose the display name (language, framework, library, tool, or platform; verify Linguist name for languages).
• Add a Simple Icon import or a custom icon in common/icons/customIcons.ts.
• Add the mapping in common/icons/languageMapping.ts in alphabetical order.
• Confirm the UI picks it up via common/configHelper.ts.
• Update docs that mention supported entries and add a changeset.

Example (Typst)

Reference commit 121e569b9899851f1df90cfcdaca6e7fa6e2739d:

• Added siTypst import and the Typst: siTypst mapping entry in common/icons/languageMapping.ts.
• Added a changeset noting the new supported language.

Notes

• Keep entries alphabetized to match existing conventions.
• Prefer Simple Icons when available; custom icons only when necessary.