# lucide-icons/lucide architecture

> Architecture diagram of the GitHub repository lucide-icons/lucide, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lucide-icons/lucide
- Repository: https://github.com/lucide-icons/lucide

## Overview

Lucide is a vector-icon library distributed through framework-specific packages. A developer selects an icon through a package API, configures its appearance and accessibility, and the framework component renders SVG output. The repository also contains icon-data generation and an optional icon-font workflow. Framework package capabilities are documented in the README; only some implementation relationships are visible in the sampled source, so unsampled package links are not inferred.

Main entry points: [`tools/build-icons/cli.ts`](https://github.com/lucide-icons/lucide/blob/main/tools/build-icons/cli.ts) (Icon generator CLI), [`tools/build-font/src/main.ts`](https://github.com/lucide-icons/lucide/blob/main/tools/build-font/src/main.ts) (Font workflow), [`packages/angular/src/lucide-icon-base.ts`](https://github.com/lucide-icons/lucide/blob/main/packages/angular/src/lucide-icon-base.ts) (Angular), [`packages/vue/src/Icon.ts`](https://github.com/lucide-icons/lucide/blob/main/packages/vue/src/Icon.ts) (Vue)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_framework["Framework packages"]
  node_lucide["Vanilla JS<br/>[lucide.ts]"]
  node_react["React<br/>[Icon.ts]"]
  node_vue["Vue<br/>[Icon.ts]"]
  node_svelte["Svelte<br/>[Icon.svelte]"]
  node_solid["Solid<br/>[Icon.tsx]"]
  node_preact["Preact<br/>[Icon.ts]"]
  node_native["React Native<br/>[Icon.ts]"]
  node_angular["Angular"]
  node_astro["Astro"]
  node_static["Static SVGs<br/>[lucide-static.ts]"]
end

subgraph group_core["Icon runtime"]
  node_icondata["Icon data<br/>[lucide-icons.ts]"]
  node_shared["Shared utilities<br/>[index.ts]"]
  node_angularconfig["Angular config<br/>[lucide-config.ts]"]
end

subgraph group_generation["Icon generation"]
  node_iconcli["Icon generator CLI<br/>[cli.ts]"]
  node_rendericons["SVG node rendering"]
  node_iconfiles["Icon file generation"]
  node_exports["Export generation"]
  node_aliases["Alias generation"]
  node_dynamicimports["Dynamic imports"]
  node_metadata["Icon metadata<br/>[getIconMetaData.ts]"]
  node_readmetadata["Metadata resolution<br/>[readAllMetadata.ts]"]
end

subgraph group_font["Font output"]
  node_fontmain["Font workflow<br/>[main.ts]"]
  node_outline["SVG outlining<br/>[outlineSVGs.ts]"]
  node_codepoints["Codepoint allocation"]
  node_fontbuild["Font construction<br/>[buildFont.ts]"]
end

subgraph group_examples["Integration examples"]
  node_router["TanStack router<br/>[router.tsx]"]
  node_routetree["Generated route tree<br/>[routeTree.gen.ts]"]
  node_vueexample["Nuxt showcase<br/>[IconShowcase.vue]"]
end

node_developer(("Developer"))

node_developer -->|"uses package"| node_lucide
node_developer -->|"uses package"| node_react
node_developer -->|"uses package"| node_vue
node_developer -->|"uses package"| node_svelte
node_developer -->|"uses package"| node_solid
node_developer -->|"uses package"| node_preact
node_developer -->|"uses package"| node_native
node_developer -->|"uses package"| node_angular
node_developer -->|"uses package"| node_astro
node_developer -->|"uses package"| node_static
node_angular -->|"reads config"| node_angularconfig
node_router -->|"uses routes"| node_routetree
node_vueexample -->|"imports package"| node_vue
node_iconcli -->|"renders nodes"| node_rendericons
node_iconcli -->|"loads metadata"| node_metadata
node_iconcli -->|"generates files"| node_iconfiles
node_iconcli -->|"generates exports"| node_exports
node_iconcli -->|"generates aliases"| node_aliases
node_iconcli -->|"generates imports"| node_dynamicimports
node_iconcli -->|"reads SVGs"| node_icondata
node_readmetadata -->|"resolves metadata"| node_metadata
node_fontmain -->|"outlines SVGs"| node_outline
node_fontmain -->|"allocates points"| node_codepoints
node_fontmain -->|"builds font"| node_fontbuild

click node_lucide "https://github.com/lucide-icons/lucide/blob/main/packages/lucide/src/lucide.ts"
click node_react "https://github.com/lucide-icons/lucide/blob/main/packages/lucide-react/src/Icon.ts"
click node_vue "https://github.com/lucide-icons/lucide/blob/main/packages/vue/src/Icon.ts"
click node_svelte "https://github.com/lucide-icons/lucide/blob/main/packages/svelte/src/Icon.svelte"
click node_solid "https://github.com/lucide-icons/lucide/blob/main/packages/solid/src/Icon.tsx"
click node_preact "https://github.com/lucide-icons/lucide/blob/main/packages/lucide-preact/src/Icon.ts"
click node_native "https://github.com/lucide-icons/lucide/blob/main/packages/lucide-react-native/src/Icon.ts"
click node_angular "https://github.com/lucide-icons/lucide/blob/main/packages/angular/src/lucide-icon-base.ts"
click node_astro "https://github.com/lucide-icons/lucide/blob/main/packages/astro/src/createLucideIcon.ts"
click node_static "https://github.com/lucide-icons/lucide/blob/main/packages/lucide-static/src/lucide-static.ts"
click node_icondata "https://github.com/lucide-icons/lucide/blob/main/packages/icons/src/lucide-icons.ts"
click node_shared "https://github.com/lucide-icons/lucide/blob/main/packages/shared/src/index.ts"
click node_angularconfig "https://github.com/lucide-icons/lucide/blob/main/packages/angular/src/lucide-config.ts"
click node_iconcli "https://github.com/lucide-icons/lucide/blob/main/tools/build-icons/cli.ts"
click node_rendericons "https://github.com/lucide-icons/lucide/blob/main/tools/build-icons/render/renderIconsObject.ts"
click node_iconfiles "https://github.com/lucide-icons/lucide/blob/main/tools/build-icons/building/generateIconFiles.ts"
click node_exports "https://github.com/lucide-icons/lucide/blob/main/tools/build-icons/building/generateExportsFile.ts"
click node_aliases "https://github.com/lucide-icons/lucide/blob/main/tools/build-icons/building/aliases/generateAliasesFiles.ts"
click node_dynamicimports "https://github.com/lucide-icons/lucide/blob/main/tools/build-icons/building/generateDynamicImports.ts"
click node_metadata "https://github.com/lucide-icons/lucide/blob/main/tools/build-icons/utils/getIconMetaData.ts"
click node_readmetadata "https://github.com/lucide-icons/lucide/blob/main/tools/build-helpers/src/readAllMetadata.ts"
click node_fontmain "https://github.com/lucide-icons/lucide/blob/main/tools/build-font/src/main.ts"
click node_outline "https://github.com/lucide-icons/lucide/blob/main/tools/build-font/src/outlineSVGs.ts"
click node_codepoints "https://github.com/lucide-icons/lucide/blob/main/tools/build-font/src/allocateCodepoints.ts"
click node_fontbuild "https://github.com/lucide-icons/lucide/blob/main/tools/build-font/src/buildFont.ts"
click node_router "https://github.com/lucide-icons/lucide/blob/main/integrations/lucide-react/tanstack-router/src/router.tsx"
click node_routetree "https://github.com/lucide-icons/lucide/blob/main/integrations/lucide-react/tanstack-router/src/routeTree.gen.ts"
click node_vueexample "https://github.com/lucide-icons/lucide/blob/main/integrations/lucide-vue/nuxt/app/components/IconShowcase.vue"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_lucide,node_react,node_vue,node_svelte,node_solid,node_preact,node_native,node_angular,node_astro,node_static toneBlue
class node_icondata,node_shared,node_angularconfig toneAmber
class node_iconcli,node_rendericons,node_iconfiles,node_exports,node_aliases,node_dynamicimports,node_metadata,node_readmetadata toneMint
class node_fontmain,node_outline,node_codepoints,node_fontbuild toneRose
class node_router,node_routetree,node_vueexample,node_developer toneIndigo
```

## Components

### Framework packages

- [Vanilla JS](https://github.com/lucide-icons/lucide/blob/main/packages/lucide/src/lucide.ts): `packages/lucide/src/lucide.ts`
- [React](https://github.com/lucide-icons/lucide/blob/main/packages/lucide-react/src/Icon.ts): `packages/lucide-react/src/Icon.ts`
- [Vue](https://github.com/lucide-icons/lucide/blob/main/packages/vue/src/Icon.ts): `packages/vue/src/Icon.ts`
- [Svelte](https://github.com/lucide-icons/lucide/blob/main/packages/svelte/src/Icon.svelte): `packages/svelte/src/Icon.svelte`
- [Solid](https://github.com/lucide-icons/lucide/blob/main/packages/solid/src/Icon.tsx): `packages/solid/src/Icon.tsx`
- [Preact](https://github.com/lucide-icons/lucide/blob/main/packages/lucide-preact/src/Icon.ts): `packages/lucide-preact/src/Icon.ts`
- [React Native](https://github.com/lucide-icons/lucide/blob/main/packages/lucide-react-native/src/Icon.ts): `packages/lucide-react-native/src/Icon.ts`
- [Angular](https://github.com/lucide-icons/lucide/blob/main/packages/angular/src/lucide-icon-base.ts): `packages/angular/src/lucide-icon-base.ts`
- [Astro](https://github.com/lucide-icons/lucide/blob/main/packages/astro/src/createLucideIcon.ts): `packages/astro/src/createLucideIcon.ts`
- [Static SVGs](https://github.com/lucide-icons/lucide/blob/main/packages/lucide-static/src/lucide-static.ts): `packages/lucide-static/src/lucide-static.ts`

### Icon runtime

- [Icon data](https://github.com/lucide-icons/lucide/blob/main/packages/icons/src/lucide-icons.ts): `packages/icons/src/lucide-icons.ts`
- [Shared utilities](https://github.com/lucide-icons/lucide/blob/main/packages/shared/src/index.ts): `packages/shared/src/index.ts`
- [Angular config](https://github.com/lucide-icons/lucide/blob/main/packages/angular/src/lucide-config.ts): `packages/angular/src/lucide-config.ts`

### Icon generation

- [Icon generator CLI](https://github.com/lucide-icons/lucide/blob/main/tools/build-icons/cli.ts): `tools/build-icons/cli.ts`
- [SVG node rendering](https://github.com/lucide-icons/lucide/blob/main/tools/build-icons/render/renderIconsObject.ts): `tools/build-icons/render/renderIconsObject.ts`
- [Icon file generation](https://github.com/lucide-icons/lucide/blob/main/tools/build-icons/building/generateIconFiles.ts): `tools/build-icons/building/generateIconFiles.ts`
- [Export generation](https://github.com/lucide-icons/lucide/blob/main/tools/build-icons/building/generateExportsFile.ts): `tools/build-icons/building/generateExportsFile.ts`
- [Alias generation](https://github.com/lucide-icons/lucide/blob/main/tools/build-icons/building/aliases/generateAliasesFiles.ts): `tools/build-icons/building/aliases/generateAliasesFiles.ts`
- [Dynamic imports](https://github.com/lucide-icons/lucide/blob/main/tools/build-icons/building/generateDynamicImports.ts): `tools/build-icons/building/generateDynamicImports.ts`
- [Icon metadata](https://github.com/lucide-icons/lucide/blob/main/tools/build-icons/utils/getIconMetaData.ts): `tools/build-icons/utils/getIconMetaData.ts`
- [Metadata resolution](https://github.com/lucide-icons/lucide/blob/main/tools/build-helpers/src/readAllMetadata.ts): `tools/build-helpers/src/readAllMetadata.ts`

### Font output

- [Font workflow](https://github.com/lucide-icons/lucide/blob/main/tools/build-font/src/main.ts): `tools/build-font/src/main.ts`
- [SVG outlining](https://github.com/lucide-icons/lucide/blob/main/tools/build-font/src/outlineSVGs.ts): `tools/build-font/src/outlineSVGs.ts`
- [Codepoint allocation](https://github.com/lucide-icons/lucide/blob/main/tools/build-font/src/allocateCodepoints.ts): `tools/build-font/src/allocateCodepoints.ts`
- [Font construction](https://github.com/lucide-icons/lucide/blob/main/tools/build-font/src/buildFont.ts): `tools/build-font/src/buildFont.ts`

### Integration examples

- [TanStack router](https://github.com/lucide-icons/lucide/blob/main/integrations/lucide-react/tanstack-router/src/router.tsx): `integrations/lucide-react/tanstack-router/src/router.tsx`
- [Generated route tree](https://github.com/lucide-icons/lucide/blob/main/integrations/lucide-react/tanstack-router/src/routeTree.gen.ts): `integrations/lucide-react/tanstack-router/src/routeTree.gen.ts`
- [Nuxt showcase](https://github.com/lucide-icons/lucide/blob/main/integrations/lucide-vue/nuxt/app/components/IconShowcase.vue): `integrations/lucide-vue/nuxt/app/components/IconShowcase.vue`

### Other components

- **Developer**

## Connections

- Developer → Vanilla JS: uses package
- Developer → React: uses package
- Developer → Vue: uses package
- Developer → Svelte: uses package
- Developer → Solid: uses package
- Developer → Preact: uses package
- Developer → React Native: uses package
- Developer → Angular: uses package
- Developer → Astro: uses package
- Developer → Static SVGs: uses package
- Angular → Angular config: reads config (evidence: `packages/angular/src/lucide-icon-base.ts`)
- TanStack router → Generated route tree: uses routes (evidence: `integrations/lucide-react/tanstack-router/src/router.tsx`)
- Nuxt showcase → Vue: imports package (evidence: `integrations/lucide-vue/nuxt/app/components/IconShowcase.vue`)
- Icon generator CLI → SVG node rendering: renders nodes (evidence: `tools/build-icons/cli.ts`)
- Icon generator CLI → Icon metadata: loads metadata (evidence: `tools/build-icons/cli.ts`)
- Icon generator CLI → Icon file generation: generates files (evidence: `tools/build-icons/cli.ts`)
- Icon generator CLI → Export generation: generates exports (evidence: `tools/build-icons/cli.ts`)
- Icon generator CLI → Alias generation: generates aliases (evidence: `tools/build-icons/cli.ts`)
- Icon generator CLI → Dynamic imports: generates imports (evidence: `tools/build-icons/cli.ts`)
- Icon generator CLI → Icon data: reads SVGs (evidence: `tools/build-icons/cli.ts`)
- Metadata resolution → Icon metadata: resolves metadata (evidence: `tools/build-helpers/src/readAllMetadata.ts`)
- Font workflow → SVG outlining: outlines SVGs (evidence: `tools/build-font/src/main.ts`)
- Font workflow → Codepoint allocation: allocates points (evidence: `tools/build-font/src/main.ts`)
- Font workflow → Font construction: builds font (evidence: `tools/build-font/src/main.ts`)
