Make all Material Symbols available from Paragon icons
I maintainer di solito rispondono entro 1 giorno
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 5/5
- Tempo stimato
- Più di una settimana
- Idoneità per principianti
- 25/100
- Tipo di issue
- Funzionalità
- Chiarezza
- Da chiarire
- Stato di attività
- Attiva
- Stack tecnologico
- javascript, react
Direzione di ricerca
Start with icons/copy-mui-icons.js, icons/README.md, and the referenced icon issues #3045, #3275, and #4086. The issue first needs decisions from the Paragon working group and design on the icon API, styles, naming, collisions, and whether to keep Material Icons; then the implementation and bundle and build measurements can be scoped. Done means those decisions are recorded, the chosen icons are available under the agreed contract, build and bundle impact is measured, and the icon documentation is updated.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
[!NOTE]
This issue was written by Claude (Claude Code) and reviewed before posting.
Goal: every Material Symbols icon importable from @openedx/paragon/icons, the way every Material Icons Sharp glyph is today.
Why: Paragon's icon set is Material Icons Sharp, copied wholesale from @material-icons/svg by icons/copy-mui-icons.js (#1302, #1313). That package has had the same 2191 names since the 2022 import; new designs are drawn with Material Symbols, which has 3940 names at one weight, 2086 of them with no Material Icons counterpart, and lighter variants of the glyphs the two sets share. Today each Symbol a design needs is a one-off SVG upload (#3275 added Newsstand that way, #4086 asks for QuickReferenceAll the same way), and there is no rule for a Symbol whose name an existing icon already uses. Current example: openedx/frontend-app-learner-dashboard#879 needs the Material Symbols import_contacts (both pages outlined), while Paragon's ImportContacts is the Material Icons Sharp glyph with a solid left page.
Prior art:
- #1302 / #1313 (2022): export every Material Icons Sharp glyph from
@material-icons/svg. - #2441 (2023):
sideEffects: falseon the icons package so unused icons tree-shake. - #3045 (2024, closed 2025-09): all Material Symbols Sharp 400 from
@material-symbols/svg-400, added next to the existing icons, skipping any name already taken. Tripled the SVG count (2317 to 6948), the docs site build ran out of memory at the default heap, bundle impact on MFEs was not measured, and review asked that frontend-build's tree-shaking of unused Paragon icons be verified first. - #3275 (2024): one Symbol SVG added by hand, as-is from fonts.google.com.
- #4086 (2026-01): asks for two more Symbols by hand and records that the Paragon WG wants to choose between an ingestion method and manual uploads.
- openedx/public-engineering#555: the Paragon 24 epic this issue belongs to.
Open questions:
- Style, weight, fill. Material Symbols ship as Outlined, Rounded and Sharp, in weights 100 to 700 (one npm package per weight,
@material-symbols/svg-<weight>), each with a-fillvariant. Paragon's existing set is Sharp; #3045 chose Symbols Sharp 400; the openedx/frontend-app-learner-dashboard#879 Figma uses Symbols Outlined 400. Which style(s), weight(s) and fill variants Paragon exports, and under what names. - Keep Material Icons? 1854 names exist in both sets, 337 Material Icons names have no Symbol (many are renamed rather than gone, e.g.
add_circle_outlineisadd_circleat fill 0), and the hand-added Paragon SVGs include four that are now Symbols (close_small,newsstand,post,text_to_speech). Whether Paragon 24 keeps the Material Icons set alongside the Symbols, drops it, or keeps only the 337 with no Symbol. - Overlap and deprecation. For a name in both sets: which glyph the bare export (
ImportContacts) means, where the other one lives (a suffix, a separate entry point such as@openedx/paragon/icons/symbols, or not exported), and the deprecation path for consumers of the old glyph: a deprecation warning on the old export, a documented rename, and the Paragon major in which it is removed. #3045 kept the old glyph on every collision, so it never answered this. - How
Icontakes an icon. TodayIcon'ssrcprop is a React component, and the contract is one import per icon (import { Add } from '@openedx/paragon/icons'; <Icon src={Add} />): every icon is a generated component inicons/es5, and the export list is the icon set. Paragon 24 can revisit that. Candidates: keep component-per-icon imports; a name-basedsrc(<Icon src="add" />) resolved from a map, which changes what tree-shaking can drop; the Material Symbols variable font, which makes style, weight and fill runtime CSS instead of build-time variants and removes the SVG set from the package. The answer constrains questions 1 to 3 and 5. - Build and bundle. The SVG count, docs site memory and MFE bundle questions from #3045, and whether frontend-build and frontend-base tree-shake unused Paragon icons, must be settled before merge.
Claude Plan
- Answer questions 1 to 4 in this issue with the Paragon WG and design, question 4 first since it bounds the others; record the answers in the issue body.
- If question 4 keeps SVG components: extend
icons/copy-mui-icons.js(or a sibling script) to copy the chosen Symbols style(s) and weight(s) from@material-symbols/svg-<weight>onnpm run build, applying the collision rule from question 3, with-fillhandling from question 1. Otherwise, theIconchange that question 4 chose. - Measure: docs site build memory, icons package size, and an MFE bundle before and after, with the tree-shaking verification from question 5.
- Deprecation mechanics for whichever Material Icons exports question 2 removes or renames: warnings on
release-23.x, removal on the Paragon 24 line. - Update
icons/README.mdand the icons docs page to say where Symbols come from and how an icon is added or updated.
- Lingua principale
- JavaScript
- Stelle
- 141
- Fork
- 101
- Merge medio
- 11h 13m
- PR unite (30g)
- 44
Preparare l'ambiente
- Nessun Dockerfile né file Docker Compose
- Ha un modello di pull request
- Leggi la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di openedx/paragon
-
bug
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 88/100
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 85/100
I maintainer di solito rispondono entro 1 giorno
-
IconButtonToggle uses aria-selected on buttons (axe aria-allowed-attr); should be aria-pressedAperta
Difficoltà 2/5 1-3 ore Idoneità per principianti 86/100
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 88/100
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
I maintainer di solito rispondono entro 1 giorno
Tutte le issue di openedx/paragon
Issue simili
-
Client execution contract accepts a grant the code never takesForse già presa Una pull request collegata a questa issue è aperta o già unita. Apertaarea: client enhancement priority: medium
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
opensro-dev/opensro#3808 ·
I maintainer di solito rispondono entro 1 giorno
-
luciano_blocktronics: sysop chat status views are both keyed TL10 and use itemFormat, which a TextView ignoresForse già presa @Z3NMA l’ha presa oggi. Apertabug
Difficoltà 2/5 1-3 ore Idoneità per principianti 82/100
NuSkooler/enigma-bbs#1058 ·
I maintainer di solito rispondono entro 1 giorno
-
marketing
Difficoltà 2/5 1-3 ore Idoneità per principianti 76/100
I maintainer di solito rispondono entro 1 giorno
-
enhancement good first issue help wanted
Difficoltà 2/5 1-3 ore Idoneità per principianti 88/100
-
enhancement good first issue severity: low
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
TMHSDigital/Static_Chess#163 ·
I maintainer di solito rispondono entro 1 giorno