Lucide est un jeu d'icônes ouvert dessiné avec un seul trait, publié sous forme de paquets séparés pour React, Vue, Svelte, Solid, Angular et JavaScript pur. La version 1.33.0 de lucide-react est arrivée dans le registre npm le 19 août 2026 sous licence ISC et contient 1776 icônes. Je décris ci-dessous ce qui en découle en pratique, y compris les points que la documentation laisse de côté.
Ce que les paquets Lucide t'apportent
Chaque icône est un composant qui rend un élément svg directement dans l'arbre du document. Il n'y a ni sprite, ni police d'icônes, ni requête réseau pour les données. Les attributs par défaut vivent dans un seul module et se lisent ainsi : xmlns réglé sur l'espace de noms SVG, width et height égaux à 24, viewBox égal à 0 0 24 24, fill réglé sur none, stroke réglé sur currentColor, strokeWidth égal à 2, et strokeLinecap et strokeLinejoin réglés sur round.
La valeur currentColor de l'attribut stroke est ici la décision de conception la plus importante. L'icône hérite de la couleur du texte du parent, donc une classe text-red-500 de Tailwind CSS colore l'icône sans code supplémentaire, et le mode sombre fonctionne tout seul tant que la couleur du texte est définie au niveau du conteneur.
La famille de paquets à la version 1.33.0, publiée le 19 août 2026, couvre lucide pour JavaScript pur, lucide-react pour React, @lucide/vue, @lucide/svelte, lucide-solid, @lucide/angular et lucide-static avec des fichiers SVG et une police. Tous déclarent la licence ISC. Les plages de dépendances peer sont disjointes et n'entrent pas en collision, car chaque paquet ne nomme que son propre framework : lucide-react accepte React dans la plage ^16.5.1 || ^17.0.0 || ^18.0.0 || ^19.0.0, @lucide/angular exige @angular/core et @angular/common en version 17 ou plus, lucide-solid exige solid-js dans la plage ^1.4.7, et @lucide/svelte n'accepte que Svelte 5. Les paquets Lucide ne dépendent pas les uns des autres, donc en installer deux à la fois ne finit pas en conflit de versions.
@lucide/lab est développé séparément et se trouve à la version 0.2.0 du 31 juillet 2026. C'est une salle d'attente pour les icônes qui n'ont pas atteint le jeu principal, et la numérotation inférieure à un est un signal honnête : ces icônes peuvent disparaître ou changer de forme.
Ce que Lucide n'a pas. Il n'y a ni icônes de marques ni logos, car ils ont été retirés dans la version 1. Il n'y a pas de variante pleine, ce que la documentation confirme : la page sur les remplissages s'ouvre sur la phrase disant que les remplissages ne sont officiellement pas pris en charge, et montre un contournement qui passe fill avec strokeWidth={0} sur les icônes Star et StarHalf. Cela fonctionne sur certaines icônes et échoue sur les autres, car les formes n'ont pas été dessinées en pensant à des contours fermés.
# installation for React, pinning the exact version
npm install lucide-react@1.33.0
# the plain JavaScript variant
npm install lucide@1.33.0
# SVG files and the font only, without the component layer
npm install lucide-static@1.33.0La licence ISC et la trace de Feather
Lucide a démarré comme un fork du projet Feather, qui était sous licence MIT. La déclaration dans le registre npm dit sèchement ISC et c'est tout ce que voient la plupart des scanners de dépendances. Le fichier de licence du dépôt en dit plus.
La racine de lucide-icons/lucide contient un fichier LICENSE, sans variante LICENSE.md, de 43 lignes et 3208 octets. Il s'ouvre sur le texte ISC complet et une mention de copyright qui indique « Copyright (c) 2026 Lucide Icons and Contributors ». Un séparateur suit, puis une phrase qui précise que les icônes listées ci-dessous sont dérivées du projet Feather. La liste contient exactement 115 noms, de airplay à zoom-out, et en dessous se trouve le texte MIT complet avec la mention « Copyright (c) 2013-present Cole Bemis », l'auteur de Feather.
La troisième source, le contenu du paquet publié, correspond au dépôt octet pour octet. L'archive décompressée de lucide-react 1.33.0 contient un fichier LICENSE identique à celui de la branche principale, et le script de build dans package.json exécute exactement cp ../../LICENSE ./LICENSE, donc il n'y a aucune place pour un décalage. Chaque fichier du répertoire dist s'ouvre en plus avec un en-tête @license lucide-react v1.33.0 - ISC.
Ce que cela signifie pour quelqu'un qui remplit un inventaire de licences dans un projet commercial. ISC et MIT sont fonctionnellement équivalentes et exigent toutes deux de conserver la mention de copyright lors de la distribution. La différence est que l'inventaire a besoin de deux mentions plutôt qu'une : Lucide Icons and Contributors pour tout le jeu, et Cole Bemis pour ces 115 icônes. Un scanner automatique qui lit le champ license du registre npm ne voit que ISC et perd simplement la mention de Feather. Si ton entreprise exige que les textes de licence complets soient livrés avec une version, inclure le fichier LICENSE en entier suffit, car les deux mentions s'y trouvent ensemble.
Il y a un autre petit piège dans la liste elle-même. Les noms de Feather y sont consignés sous leur forme historique, donc tu y trouveras alert-circle, alert-triangle et more-horizontal, alors que dans le Lucide actuel ces icônes portent des noms principaux différents et ne survivent que comme alias. La liste concerne l'origine de la forme, pas le nom d'import actuel, et essayer de la faire correspondre automatiquement aux noms de composants utilisés dans ton code produit de faux résultats dans les deux sens.
La version 1.0 et ce qui en est tombé
Jusqu'en mars 2026, la numérotation suivait 0.x, où chaque nouveau numéro après le point signifiait de nouvelles icônes, et la dernière version de cette série était 0.544.0 du 11 septembre 2025. La version 1.0.0 est arrivée sur npm le 23 mars 2026, mais la note de version sur GitHub s'ouvre sur un avertissement disant qu'elle a été publiée par inadvertance et qu'il faut utiliser la 1.0.1 à la place. La correction est sortie le même jour, environ une heure plus tard, et elle porte la vraie note de version.
Les changements cassants de la version 1 sont précis. Les icônes de marques ont été retirées, et la note de migration liste quatorze noms : Chromium, Codepen, Codesandbox, Dribbble, Facebook, Figma, Framer, Github, Gitlab, Instagram, LinkedIn, Pocket, RailSymbol et Slack. La documentation renvoie aux ressources officielles des marques elles-mêmes ou à la collection Simple Icons pour les remplacements. Le build UMD a aussi été retiré pour tous les paquets sauf lucide, laissant ESM et CJS. L'attribut aria-hidden est désormais défini par défaut. Le paquet lucide-vue-next a été renommé en @lucide/vue, et Angular a reçu une nouvelle implémentation autonome dans @lucide/angular. Des fournisseurs de contexte ont été ajoutés pour React, Vue, Svelte et Solid, les points de code de la police ont été stabilisés, et la prise en charge du shadow DOM est arrivée dans le paquet lucide.
L'effet de bord est visible dans le registre. Les anciens paquets se sont figés au seuil de la version un : lucide-vue-next est à 1.0.0 et lucide-svelte à 1.0.1, tous deux du 23 mars 2026. Cela compte pour les projets sur Svelte 3 ou 4, car @lucide/svelte n'accepte que Svelte 5, et lucide-svelte, figé, ne recevra pas de nouvelles icônes.
Rythme des versions par ailleurs élevé. En comptant d'après les dates de publication sur npm, douze versions mineures sont sorties entre le 28 juin et le 19 août 2026, de la 1.22.0 à la 1.33.0, et le nombre total de versions de lucide-react dans le registre a dépassé 685. Le dépôt compte environ 24,1 mille étoiles et 1,5 mille forks, avec environ 290 issues ouvertes et 271 pull requests ouvertes. Ce dernier nombre est surtout fait de propositions de nouvelles icônes qui attendent la revue de design, ce qui, à cette taille de jeu, est par nature un goulot d'étranglement.
La taille du paquet, la surprise la plus courante
C'est là que se trouve le vrai problème, celui que la plupart des textes sur Lucide taisent. Le paquet lucide-react à la version 1.33.0 se décompresse en 31,4 mégaoctets répartis sur 4108 fichiers. La version JavaScript pur prend 21,1 mégaoctets, et lucide-static pas moins de 48,3 mégaoctets. Ce n'est pas une taille qui atteint le navigateur, mais elle atteint le disque, le cache du gestionnaire de paquets et l'image de conteneur avec l'étape de build.
La structure ressemble à ceci. Le répertoire dist/esm/icons contient 2034 modules. Parmi eux, 1776 sont les icônes proprement dites, 257 sont des modules conservés sous d'anciens noms pour la rétrocompatibilité, et un, index.mjs, est un fichier barrel qui ne contient aucune icône. Un module isolé est petit : camera.mjs pèse 692 octets et exporte un tableau __iconNode qui décrit les formes plus un composant prêt à l'emploi. Le fichier d'entrée principal dist/esm/lucide-react.mjs fait 1791 lignes de pures réexportations, et le champ sideEffects dans package.json est réglé sur false. Lors d'un build ESM avec une élimination du code mort qui fonctionne, importer trois icônes aboutit à trois modules dans la sortie, et c'est le chemin que Lucide recommande.
Les ennuis commencent hors de ce chemin. La variante CJS est un seul fichier dist/cjs/lucide-react.js de 978 743 octets avec les 1776 icônes écrites dedans. Il n'y a pas de modules CJS par icône. Tout environnement qui s'appuie sur le champ main, c'est-à-dire un ancien Jest sans transformation ESM, certaines configurations de rendu côté serveur et les outils d'analyse de dépendances, chargera les 956 kilooctets complets pour obtenir une seule flèche. De plus, package.json n'a aucun champ exports, donc des imports profonds comme lucide-react/dist/esm/icons/camera.mjs fonctionnent techniquement mais reposent sur une organisation de répertoires que personne n'a promis de conserver entre les versions.
La deuxième surprise concerne les types. Le fichier dist/lucide-react.d.ts pèse 2 293 869 octets, et ses deux variantes se trouvent à côté, lucide-react.prefixed.d.ts et lucide-react.suffixed.d.ts, chacune d'environ 2,2 mégaoctets. L'essentiel vient d'un commentaire JSDoc attaché à chaque icône, qui porte un aperçu sous forme d'image SVG encodée en base64. Le confort dans l'éditeur est réel, et le coût aussi : le serveur de langage TypeScript doit mâcher tout cela à chaque ouverture de projet.
Le build navigateur depuis un CDN n'a aucune élimination du code mort. Le fichier dist/umd/lucide.min.js du paquet lucide pèse 419 264 octets, environ 97 kilooctets après compression gzip, et contient le jeu complet. La documentation du paquet JavaScript pur attache elle-même un commentaire d'avertissement à l'appel createIcons({ icons }), indiquant que cela importera et embarquera toutes les icônes.
// the recommended static import, one icon means one module in the build output
import { Camera, ChevronRight } from 'lucide-react'
export function Toolbar() {
return (
<div className="text-slate-600">
<Camera size={20} strokeWidth={1.5} />
<ChevronRight size={20} absoluteStrokeWidth />
</div>
)
}Si le nom de l'icône vient d'une base de données ou d'un système de gestion de contenu, DynamicIcon existe pour cela, mais la documentation le déconseille ouvertement pour les cas statiques et liste quatre coûts : toutes les icônes sont importées au moment du build, ce qui allonge le build ; le bundler crée un module séparé par icône, ce qui augmente le nombre de requêtes réseau ; un flash est visible pendant le chargement ; et avec le rendu côté serveur, tu dois t'assurer que l'icône est disponible lors du rendu initial.
// dynamic icon selection by name, together with a fallback component
import { DynamicIcon, iconNames } from 'lucide-react/dynamic'
import { LucideProvider } from 'lucide-react'
const Placeholder = () => <span className="block h-6 w-6 rounded bg-slate-200" />
export function CmsIcon({ name }) {
const safeName = iconNames.includes(name) ? name : 'circle-help'
return (
<LucideProvider size={24} strokeWidth={2} color="currentColor">
<DynamicIcon name={safeName} fallback={Placeholder} />
</LucideProvider>
)
}Attributs des icônes et contexte
Le composant accepte color, size, strokeWidth, absoluteStrokeWidth et className, et transmet par ailleurs n'importe quel attribut SVG à l'élément. Le type LucideProps étend les attributs SVG avec deux champs propres : size de type string | number et absoluteStrokeWidth de type boolean.
absoluteStrokeWidth résout un problème précis. Par défaut, l'épaisseur du trait est exprimée dans les unités du système de coordonnées de l'icône, donc agrandir l'icône à 48 pixels double aussi l'épaisseur du trait. Avec l'option activée, le composant calcule l'épaisseur avec la formule strokeWidth * 24 / size, ce qui garde le trait à un poids constant quelle que soit la taille. Pour des icônes placées à côté de texte de tailles différentes, c'est une différence que l'on voit à l'œil nu.
Le contexte introduit dans la version 1 te permet de définir ces valeurs une fois pour un sous-arbre. LucideProvider accepte size, color, strokeWidth, absoluteStrokeWidth et className, et chacun peut être surchargé sur une icône individuelle, car la valeur de la prop l'emporte sur celle du contexte. Le hook useLucideContext est exporté au cas où tu aurais besoin de lire ces réglages dans ton propre composant.
L'accessibilité est gérée de façon sensée. Le composant vérifie si l'une des props passées commence par aria-, ou est égale à role, ou est égale à title. Si aucune n'est présente et que l'icône n'a pas d'enfants, il ajoute aria-hidden="true". Une icône décorative sort donc de l'arbre d'accessibilité sans travail de ta part, tandis qu'une icône porteuse de sens exige un aria-label explicite, ce qui est le bon ordre d'incitations.
Enfin, les classes CSS. L'élément reçoit toujours une classe lucide, la classe du contexte, la classe passée dans className et une classe avec le nom de l'icône sous la forme lucide-camera. C'est pratique pour le style global, mais avec Tailwind CSS il faut se rappeler que les classes propres à la bibliothèque sont placées avant les tiennes et que l'ordre dans l'attribut ne décide pas de la spécificité.
Noms, alias et bruit dans l'autocomplétion
Le fichier d'entrée principal exporte 6092 noms distincts pour 1776 icônes, soit environ trois noms et demi par icône. Cela vient de trois styles de nommage plus des alias historiques. L'icône de maison est disponible sous House, HouseIcon et LucideHouse, et en plus l'ancien nom Home mène au même module. De même, edit-2 a été renommé en pen, tandis que sort-desc survit comme alias d'arrow-down-wide-narrow.
L'effet de bord apparaît à la première frappe dans l'éditeur : l'autocomplétion enterre la liste sous des variantes de la même icône. La documentation propose deux étapes. La première est de désactiver les imports automatiques depuis ce paquet en réglant js/ts.preferences.autoImportFileExcludePatterns dans .vscode/settings.json. La seconde est un fichier de déclaration personnalisé qui redirige le module vers une variante avec un seul style de nommage.
// lucide-react.d.ts, usually inside the project's @types directory
declare module 'lucide-react' {
// suffixed variant: HouseIcon, CameraIcon, ChevronRightIcon
export * from 'lucide-react/dist/lucide-react.suffixed'
// alternatively the prefixed variant:
// export * from 'lucide-react/dist/lucide-react.prefixed'
}Un point à part est l'ambiguïté des noms eux-mêmes à cette taille de jeu. Avec 1776 icônes, il est difficile de deviner si la forme que tu veux s'appelle file-text, notebook-text ou scroll-text, et chacune existe et a un aspect différent. L'API publique du site du projet à lucide.dev/api/tags renvoie une table de correspondance entre le nom de l'icône et une liste de mots-clés et contient exactement 1776 entrées, ce qui correspond au contenu du paquet. C'est le moyen le plus rapide de construire ta propre recherche ou de vérifier dans un script qu'un nom utilisé dans du contenu éditorial existe réellement.
// plain JavaScript: import only the icons you need, not the whole icons object
import { createIcons, Menu, ArrowRight, Globe } from 'lucide'
createIcons({
icons: {
Menu,
ArrowRight,
Globe
}
})Lucide à côté d'Iconify, Heroicons et Radix Icons
La différence tient d'abord au modèle de distribution, pas au nombre d'icônes. Lucide te donne un paquet par framework et un composant par icône, ce qui rend le paquet énorme et la sortie du build petite. Iconify inverse cet arrangement : un petit composant universel tire les données d'icônes d'une API ou de paquets de jeux séparés, ce qui te donne accès à de nombreux jeux via une seule interface mais introduit soit une dépendance à l'exécution envers une source de données, soit une étape de configuration supplémentaire pour le mode hors ligne.
| Jeu | Modèle de distribution | Licence | Version et date de publication npm | Paquet décompressé |
|---|---|---|---|---|
Lucide, lucide-react | un paquet par framework, un composant par icône, 1776 icônes | ISC, plus une mention MIT pour 115 icônes issues de Feather | 1.33.0, 19 août 2026 | 31,4 Mo, 4108 fichiers |
Iconify, @iconify/react | un composant, données d'icônes depuis une API ou des paquets de jeux | MIT | 6.0.2, 15 septembre 2025 | 0,21 Mo, 16 fichiers |
Heroicons, @heroicons/react | un paquet, quatre variantes : 24 outline, 24 solid, 20 solid, 16 solid | MIT | 2.2.0, 18 novembre 2024 | 3,7 Mo, 5183 fichiers |
Radix Icons, @radix-ui/react-icons | un paquet, 318 icônes sur une grille de 15 par 15 | MIT | 1.3.2, 14 novembre 2024 | 3,4 Mo, 332 fichiers |
Heroicons compte environ 325 icônes dans la variante 24 outline et le même nombre en 24 solid, donc il fournit ce qui manque à Lucide : une variante pleine toute prête. Le prix est un jeu bien plus petit. Radix Icons vise les mises en page d'interface denses, dessine sur une grille de 15 par 15 et contient 318 icônes, mais la dernière version date de novembre 2024, donc au moment de choisir il est juste de le traiter comme un jeu fermé plutôt que comme un jeu en croissance active. Si tu utilises le reste de la famille Radix UI, la cohérence visuelle plaide encore en sa faveur.
La popularité de Lucide vient en grande partie d'une seule décision prise par un autre projet. Les composants générés par shadcn/ui importent les icônes directement depuis lucide-react : accordion utilise ChevronDown, dialog utilise X, et select utilise Check, ChevronDown et ChevronUp. Note ici que le champ dependencies dans les descriptions de registre de ces éléments ne liste que le paquet Radix correspondant, donc lucide-react doit déjà être présent dans le projet. La même dépendance se propage dans les bibliothèques construites sur cette base, dont Magic UI, tandis que HeroUI suit sa propre voie et n'impose pas ce jeu.
Une approche assez différente vient d'Iconify : au lieu d'un seul jeu, il donne une interface unique à 236 jeux et plus de trois cent mille icônes, donc tu y trouveras une variante pleine et des icônes de marques, deux choses que Lucide n'a pas. Deux points sont à peser toutefois. Le mode par défaut du composant récupère les données d'icônes sur le serveur public de l'éditeur, ce qui signifie une requête vers l'infrastructure de quelqu'un d'autre à chaque rendu et aucun accord de disponibilité d'aucune sorte. Le second est la licence : les jeux portent leurs propres conditions, deux d'entre eux interdisent l'usage commercial et six reposent sur des licences de la famille GPL, donc l'audit doit se faire jeu par jeu plutôt qu'une seule fois pour l'ensemble.
Erreurs courantes
Importer tout l'objet icons dans le paquet JavaScript pur et appeler createIcons({ icons }). Cela fait entrer le jeu complet dans la sortie du build et c'est le seul endroit où la documentation elle-même met un avertissement dans le code de l'exemple.
Supposer que n'importe quel bundler éliminera le code mort. L'élimination fonctionne pour ESM, où chaque icône est un module séparé, et pas pour le chemin CJS, où tout se trouve dans un seul fichier de 956 kilooctets. Si quelque chose dans ta configuration de test ou ton étape de rendu côté serveur s'appuie sur le champ main, vérifie ce qui a réellement été chargé.
Des imports profonds comme lucide-react/dist/esm/icons/camera.mjs dans l'espoir d'une sortie plus petite. Le paquet n'a pas de champ exports, donc un tel chemin fonctionne par accident plutôt que par contrat, et il peut disparaître quand Lucide change sa configuration de build.
Régler la taille de l'icône via width et height en CSS en laissant strokeWidth intact. Le trait grossit avec l'icône, ce qui fait paraître une icône de 48 pixels plus lourde que le texte autour. La bonne réponse est absoluteStrokeWidth.
Supposer que les icônes de marques font encore partie du jeu. Dans le code antérieur à la version 1, des imports comme Github ou Figma fonctionnaient ; après la mise à niveau vers la version un, ils ne compilent plus et doivent être remplacés par un SVG personnalisé ou un autre jeu.
Écrire simplement ISC dans l'inventaire des licences d'après le champ du registre npm. La mention MIT pour les 115 icônes héritées de Feather se trouve dans le même fichier de licence, et un scanner qui ne lit que les métadonnées du paquet ne la verra pas.
FAQ
Combien d'icônes compte Lucide 1.33.0 ?
Exactement 1776. C'est le nombre de modules d'icônes réexportés depuis le fichier d'entrée principal de lucide-react, et c'est le nombre d'entrées que renvoie l'API publique du site du projet à lucide.dev/api/tags. Le répertoire dist/esm/icons, lui, contient 2034 modules, car 257 d'entre eux sont d'anciens noms conservés pour la rétrocompatibilité et un est le fichier barrel index.mjs.
Lucide a-t-il une variante pleine ?
Non. La documentation déclare clairement que les remplissages ne sont officiellement pas pris en charge, et montre un contournement avec l'attribut fill plus strokeWidth={0} en prenant comme exemple les icônes Star et StarHalf. Cela fonctionne sur les icônes dont les contours sont fermés et échoue sur les autres. Si une variante pleine est une exigence du projet, Heroicons en fournit une pour toutes.
La licence ISC suffit-elle pour un projet commercial ?
Oui, ISC est une licence permissive, autorise l'usage commercial et exige seulement de conserver la mention de copyright. Tu dois toutefois reporter les deux mentions du fichier LICENSE dans ton inventaire, c'est-à-dire ISC pour l'ensemble du jeu et MIT avec le copyright de Cole Bemis pour les 115 icônes issues de Feather. Le plus simple est de livrer ce fichier en entier.
Pourquoi le paquet pèse-t-il 31 mégaoctets si Lucide met en avant l'élimination du code mort ?
Parce que ce sont deux choses différentes. Ce qui se trouve sur le disque est le jeu complet de 1776 icônes sous trois formes, ESM, CJS et déclarations de types, les seuls fichiers .d.ts occupant plus de 6,6 mégaoctets à cause des aperçus SVG dans les commentaires. Seules les icônes que tu importes réellement atteignent le navigateur, à condition de construire via ESM.
Quel paquet choisir pour Svelte ?
Pour Svelte 5, il y a @lucide/svelte à la version 1.33.0. Pour Svelte 3 et 4, lucide-svelte reste, mais ce paquet est à la 1.0.1 du 23 mars 2026 et ne recevra pas de nouvelles icônes. Par analogie, dans Vue le nom actuel est @lucide/vue, tandis que lucide-vue-next s'est figé à 1.0.0.
Peut-on utiliser Lucide sans gestionnaire de paquets ?
Oui, via le fichier UMD depuis un CDN, mais sans élimination du code mort. Le fichier dist/umd/lucide.min.js pèse 419 264 octets, environ 97 kilooctets après compression, et contient toutes les icônes. La documentation déconseille de pointer sur @latest et recommande de figer une version exacte dans l'URL.