Remove UMD support

* [github] Added issue template forms

* [github] yaml => yml

* Syntax fixes

* Further syntax fixes

* Sort issue templates

* Update 02_bug_report.yml

* Added icons/turntable.svg

* Added icons/turntable.json

---------

Co-authored-by: Karsa <karsa@karsa.org>

.cspell/custom-words.txt

@@ -8,10 +8,10 @@ squircle
 strikethrough
 touchpad
 ungroup
-pilcrow
 toc
 
 # Brands
 codepen
 codesandbox
 dribbble
+x.com

.github/ISSUE_TEMPLATE/02_bug_report.yml

@@ -22,6 +22,7 @@ body:
         - label: lucide-svelte
         - label: lucide-vue
         - label: lucide-vue-next
+        - label: lucide-astro
         - label: Figma plugin
         - label: source/main
         - label: other/not relevant

.github/ISSUE_TEMPLATE/04_feature_request.yml

@@ -22,6 +22,7 @@ body:
         - label: lucide-svelte
         - label: lucide-vue
         - label: lucide-vue-next
+        - label: lucide-astro
         - label: Figma plugin
         - label: all JS packages
         - label: site

.github/actions/build-and-test.yml

@@ -1,44 +0,0 @@
-name: 'Build and Test'
-description: 'Builds and test a package'
-
-inputs:
-  name:
-    description: “Name of the package”
-    required: true
-
-runs:
-  using: 'composite'
-  steps:
-    - uses: actions/checkout@v4
-    - uses: actions/setup-node@v4
-      with:
-        node-version: 16
-
-    - uses: pnpm/action-setup@v2
-      name: Install pnpm
-      id: pnpm-install
-      with:
-        version: 8
-        run_install: false
-
-    - name: Get pnpm store directory
-      id: pnpm-cache
-      run: |
-        echo "STORE_PATH=$(pnpm store path)" >> $GITHUB_OUTPUT
-
-    - uses: actions/cache@v3
-      name: Setup pnpm cache
-      with:
-        path: ${{ steps.pnpm-cache.outputs.STORE_PATH }}
-        key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
-        restore-keys: |
-          ${{ runner.os }}-pnpm-store-
-
-    - name: Install dependencies
-      run: pnpm install --filter lucide-preact
-
-    - name: Build
-      run: pnpm --filter lucide-preact build
-
-    - name: Test
-      run: pnpm --filter lucide-preact test

.github/actions/check-icons.yml

@@ -1,41 +0,0 @@
-name: 'Check icons'
-description: 'Cross-checks icon and category references in JSON descriptors'
-
-inputs:
-  name:
-    description: “Name of the package”
-    required: true
-
-runs:
-  using: 'composite'
-  steps:
-    - uses: actions/checkout@v4
-    - uses: actions/setup-node@v4
-      with:
-        node-version: 16
-
-    - uses: pnpm/action-setup@v2
-      name: Install pnpm
-      id: pnpm-install
-      with:
-        version: 8
-        run_install: false
-
-    - name: Get pnpm store directory
-      id: pnpm-cache
-      run: |
-        echo "STORE_PATH=$(pnpm store path)" >> $GITHUB_OUTPUT
-
-    - uses: actions/cache@v3
-      name: Setup pnpm cache
-      with:
-        path: ${{ steps.pnpm-cache.outputs.STORE_PATH }}
-        key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
-        restore-keys: |
-          ${{ runner.os }}-pnpm-store-
-
-    - name: Install dependencies
-      run: pnpm install --filter .
-
-    - name: Check icons and categories
-      run: pnpm checkIcons

.github/labeler.yml

@@ -79,6 +79,12 @@
       - any-glob-to-any-file:
           - 'packages/lucide-solid/*'
 
+# For changes in the lucide astro package
+🚀 astro package:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'packages/astro/*'
+
 # For changes in the lucide static package
 🪨 static package:
   - changed-files:

.github/pull_request_template.md

@@ -1,16 +1,18 @@
 <!-- Thank you for contributing! -->
 
+<!--
+PR Title Guidelines:
+
+Please use the format: <type>(<scope>): <short description>
+
+Example: feat(icons): added `camera` icon
+
+Available types: fix, feat, perf, docs, style, refactor, test, chore, ci, build
+Common scopes: icons, docs, studio, site, dev
+-->
+
 <!-- Insert `closes #issueNumber` here if merging this PR will resolve an existing issue -->
-
+## Description
-## What is the purpose of this pull request?
-<!-- Please choose one of the following, and put an "x" next to it. -->
-- [ ] New Icon
-- [ ] Bug fix
-- [ ] New Feature
-- [ ] Documentation update
-- [ ] Other:
-
-### Description
 <!-- Please insert your description here and provide info about the "what" this PR is contribution -->
 
 ### Icon use case <!-- ONLY for new icons, remove this part if not icon PR -->

.github/workflows/ci.yml

@@ -9,20 +9,18 @@ on:
 
 jobs:
   create-release:
-    if: github.repository == 'lucide-icons/lucide'
+    if: github.repository == 'lucide-icons/lucide' && startsWith(github.event.head_commit.message, 'feat(icons)')
     runs-on: ubuntu-latest
     outputs:
       VERSION: ${{ steps.new-version.outputs.NEW_VERSION }}
 
     steps:
       - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v2
+      - uses: pnpm/action-setup@v4
-        with:
-          version: 8
       - uses: actions/setup-node@v4
         with:
-          node-version: 18
           cache: 'pnpm'
+          node-version-file: 'package.json'
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
@@ -63,8 +61,40 @@ jobs:
         uses: softprops/action-gh-release@v1
         with:
           tag_name: ${{ steps.new-version.outputs.NEW_VERSION }}
-          name: New icons ${{ steps.new-version.outputs.NEW_VERSION }}
+          name: Version ${{ steps.new-version.outputs.NEW_VERSION }}
-          body: ${{ steps.change-log.outputs.CHANGE_LOG }}
+          generate_release_notes: true
+
+  test-semantic-release:
+    if: github.repository == 'lucide-icons/lucide'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Semantic Release
+        id: semantic
+        uses: cycjimmy/semantic-release-action@v4
+        with:
+          tag_format: ${version}
+          branches: |
+            ['new-release-workflow']
+          extends: |
+            semantic-release-monorepo
+          extra_plugins: |
+            @semantic-release/github
+            @semantic-release/git
+            @semantic-release/release-notes-generator
+            conventional-changelog-conventionalcommits
+
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Log output
+        if: steps.semantic.outputs.new_release_published == 'true'
+        run: |
+          echo ${{ steps.semantic.outputs.new_release_version }}
+          echo ${{ steps.semantic.outputs.new_release_major_version }}
+          echo ${{ steps.semantic.outputs.new_release_minor_version }}
+          echo ${{ steps.semantic.outputs.new_release_patch_version }}
 
   start-release:
     if: github.repository == 'lucide-icons/lucide'

.github/workflows/close-issue-with-banned-phrases.yml

@@ -0,0 +1,35 @@
+name: Close Issue with Banned Phrases
+
+on:
+  issues:
+    types: [opened]
+
+jobs:
+  block_phrases:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Check for blocked phrases in issue title
+        run: |
+          ISSUE_TITLE=$(jq -r '.issue.title' "$GITHUB_EVENT_PATH")
+          BLOCKED_PHRASES=("twitter" "whatsapp" "logo" "google" "tiktok" "facebook" "slack" "discord" "bluesky" "spotify" "behance" "pix" "x.com" "telegram")
+
+          # Check title and body for blocked phrases
+          for PHRASE in "${BLOCKED_PHRASES[@]}"
+          do
+            if echo "$ISSUE_TITLE" | grep -i "$PHRASE"; then
+              gh issue close ${{ github.event.issue.number }} --reason "not planned" --comment "This looks like a duplicate, use the [search](https://github.com/lucide-icons/lucide/issues?q=is%3Aissue+$PHRASE) to find similar issues.
+
+          Read more about brand guideline rules at [We're not accepting new Brand icons #670](https://github.com/lucide-icons/lucide/issues/670).
+
+          Always happy to help on [Discord](https://discord.gg/EH6nSts)."
+              gh issue lock ${{ github.event.issue.number }} --reason spam
+              exit 1
+            fi
+          done
+        env:
+          GH_TOKEN: ${{ github.token }}

.github/workflows/comment-icon-preview.yml

@@ -0,0 +1,58 @@
+name: Icon preview comment
+
+on:
+  workflow_run:
+    workflows: ['Pull request icon preview']
+    types:
+      - completed
+
+jobs:
+  upload:
+    runs-on: ubuntu-latest
+    if: >
+      github.event.workflow_run.event == 'pull_request' &&
+      github.event.workflow_run.conclusion == 'success'
+    steps:
+      - name: 'Download artifact'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            let allArtifacts = await github.rest.actions.listWorkflowRunArtifacts({
+               owner: context.repo.owner,
+               repo: context.repo.repo,
+               run_id: context.payload.workflow_run.id,
+            });
+            let matchArtifact = allArtifacts.data.artifacts.filter((artifact) => {
+              return artifact.name == "pr_number"
+            })[0];
+            let download = await github.rest.actions.downloadArtifact({
+               owner: context.repo.owner,
+               repo: context.repo.repo,
+               artifact_id: matchArtifact.id,
+               archive_format: 'zip',
+            });
+            const fs = require('fs');
+            fs.writeFileSync('${{github.workspace}}/pr_number.zip', Buffer.from(download.data));
+
+      - name: 'Unzip artifact'
+        run: unzip pr_number.zip
+
+      - name: 'Get PR number'
+        run: echo "number=$(cat NR)" >> $GITHUB_OUTPUT
+        id: pr-number
+
+      - name: Find Comment
+        uses: peter-evans/find-comment@v2
+        id: pr-comment
+        with:
+          issue-number: ${{ steps.pr-number.outputs.number }}
+          comment-author: 'github-actions[bot]'
+          body-includes: Added or changed icons
+
+      - name: Create or update comment
+        uses: peter-evans/create-or-update-comment@v3
+        with:
+          comment-id: ${{ steps.pr-comment.outputs.comment-id }}
+          issue-number: ${{ steps.pr-number.outputs.number }}
+          body-path: comment-markup.md
+          edit-mode: replace

.github/workflows/labeler.yml

@@ -9,4 +9,5 @@ jobs:
       pull-requests: write
     runs-on: ubuntu-latest
     steps:
+      - uses: actions/checkout@v4
       - uses: actions/labeler@v5

.github/workflows/lint-code.yml

@@ -1,22 +1,20 @@
-name: Linting
+name: Linting PR
 
 on:
   pull_request:
-    branches:
+    paths-ignore:
-      - '**'
+      - icons/*.svg
 
 jobs:
-  linting:
+  lint-code:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v2
+      - uses: pnpm/action-setup@v4
-        with:
-          version: 8
       - uses: actions/setup-node@v4
         with:
-          node-version: 18
           cache: 'pnpm'
+          node-version-file: 'package.json'
 
       - name: Install Dependencies
         run: pnpm install --frozen-lockfile

.github/workflows/lint-pr-title.yml

@@ -0,0 +1,32 @@
+name: Linting PR
+
+on:
+  pull_request:
+    types:
+      - opened
+      - edited
+      - reopened
+
+jobs:
+  lint-pr-title:
+    name: PR Title Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: amannn/action-semantic-pull-request@v5
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          types: |
+            fix
+            feat
+            perf
+            refactor
+            test
+            style
+            docs
+            ci
+            build
+            chore
+          requireScope: true
+          ignoreLabels: |
+            bot

.github/workflows/linting-icons.yml

@@ -0,0 +1,39 @@
+name: Linting Icons
+
+on:
+  pull_request:
+    paths:
+      - 'icons/*'
+
+jobs:
+  lint-filenames:
+    name: Lint Filenames
+    if: github.repository == 'lucide-icons/lucide'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: 'package.json'
+      - name: Get changed files
+        id: changed-files
+        uses: tj-actions/changed-files@v46
+        with:
+          files: icons/*
+
+      - name: Generate annotations
+        run: node ./scripts/lintFilenames.mts
+        env:
+          CHANGED_FILES: ${{ steps.changed-files.outputs.all_changed_files }}
+
+  lint-aliases:
+    name: Check Uniqueness of Aliases
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - name: Check Uniqueness of Aliases
+        run: "! cat <(printf \"%s\\n\" icons/*.json | while read -r name; do basename \"$name\" .json; done) <(jq -cr 'select(.aliases) | .aliases[] | if type==\"string\" then . else .name end' icons/*.json) | sort | uniq -c | grep -ve '^\\s*1 '"

.github/workflows/lucide-angular.yml

@@ -12,13 +12,11 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v2
+      - uses: pnpm/action-setup@v4
-        with:
-          version: 8
       - uses: actions/setup-node@v4
         with:
-          node-version: 18
           cache: 'pnpm'
+          node-version-file: 'package.json'
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
@@ -29,14 +27,12 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v2
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
         with:
-          version: 8
-      - uses: actions/setup-node@v3.8.1
-        with:
-          node-version: 18
           cache: 'pnpm'
+          node-version-file: 'package.json'
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile

.github/workflows/lucide-astro.yml

@@ -1,11 +1,11 @@
-name: Lucide Vue checks
+name: Lucide Astro Checks
 
 on:
   pull_request:
     paths:
-      - packages/lucide-vue/**
+      - packages/astro/**
+      - packages/shared/**
       - tools/build-icons/**
-      - tools/rollup-plugins/**
       - pnpm-lock.yaml
 
 jobs:
@@ -14,33 +14,29 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - uses: pnpm/action-setup@v2
-        with:
-          version: 8
       - uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version-file: 'package.json'
           cache: 'pnpm'
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
 
       - name: Build
-        run: pnpm --filter lucide-vue build
+        run: pnpm --filter @lucide/astro build
 
   test:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
       - uses: pnpm/action-setup@v2
-        with:
-          version: 8
       - uses: actions/setup-node@v3.8.1
         with:
-          node-version: 18
+          node-version-file: 'package.json'
           cache: 'pnpm'
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
 
       - name: Test
-        run: pnpm --filter lucide-vue test
+        run: pnpm --filter @lucide/astro test

.github/workflows/lucide-font.yml

@@ -3,7 +3,6 @@ name: Lucide font checks
 on:
   pull_request:
     paths:
-      - icons/**
       - tools/build-font/**
       - pnpm-lock.yaml
 
@@ -12,13 +11,11 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v2
+      - uses: pnpm/action-setup@v4
-        with:
-          version: 8
       - uses: actions/setup-node@v4
         with:
-          node-version: 18
           cache: 'pnpm'
+          node-version-file: 'package.json'
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
@@ -30,7 +27,7 @@ jobs:
         run: pnpm build:font
 
       - name: 'Upload to Artifacts'
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: lucide-font
           path: lucide-font

.github/workflows/lucide-preact.yml

@@ -4,6 +4,7 @@ on:
   pull_request:
     paths:
       - packages/lucide-preact/**
+      - packages/shared/**
       - tools/build-icons/**
       - tools/rollup-plugins/**
       - pnpm-lock.yaml
@@ -13,13 +14,11 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v2
+      - uses: pnpm/action-setup@v4
-        with:
-          version: 8
       - uses: actions/setup-node@v4
         with:
-          node-version: 18
           cache: 'pnpm'
+          node-version-file: 'package.json'
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile

.github/workflows/lucide-react-native.yml

@@ -4,22 +4,37 @@ on:
   pull_request:
     paths:
       - packages/lucide-react-native/**
+      - packages/shared/**
       - tools/build-icons/**
       - tools/rollup-plugins/**
       - pnpm-lock.yaml
 
 jobs:
-  lucide-react-native:
+  build:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v2
+      - uses: pnpm/action-setup@v4
-        with:
-          version: 8
       - uses: actions/setup-node@v4
         with:
-          node-version: 18
           cache: 'pnpm'
+          node-version-file: 'package.json'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build
+        run: pnpm --filter lucide-react-native build
+
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with:
+          cache: 'pnpm'
+          node-version-file: 'package.json'
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile

.github/workflows/lucide-react.yml

@@ -4,6 +4,7 @@ on:
   pull_request:
     paths:
       - packages/lucide-react/**
+      - packages/shared/**
       - tools/build-icons/**
       - tools/rollup-plugins/**
       - scripts/generateNextJSAliases.mjs
@@ -14,13 +15,11 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v2
+      - uses: pnpm/action-setup@v4
-        with:
-          version: 8
       - uses: actions/setup-node@v4
         with:
-          node-version: 18
           cache: 'pnpm'
+          node-version-file: 'package.json'
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
@@ -31,14 +30,12 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v2
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
         with:
-          version: 8
-      - uses: actions/setup-node@v3.8.1
-        with:
-          node-version: 18
           cache: 'pnpm'
+          node-version-file: 'package.json'
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile

.github/workflows/lucide-shared.yml

@@ -0,0 +1,24 @@
+name: Lucide Shared Checks
+
+on:
+  pull_request:
+    paths:
+      - packages/shared/**
+      - pnpm-lock.yaml
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with:
+          cache: 'pnpm'
+          node-version-file: 'package.json'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Test
+        run: pnpm --filter lucide-react test

.github/workflows/lucide-solid.yml

@@ -4,6 +4,7 @@ on:
   pull_request:
     paths:
       - packages/lucide-solid/**
+      - packages/shared/**
       - tools/build-icons/**
       - tools/rollup-plugins/**
       - pnpm-lock.yaml
@@ -13,13 +14,11 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v2
+      - uses: pnpm/action-setup@v4
-        with:
-          version: 8
       - uses: actions/setup-node@v4
         with:
-          node-version: 18
           cache: 'pnpm'
+          node-version-file: 'package.json'
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
@@ -30,14 +29,12 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v2
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
         with:
-          version: 8
-      - uses: actions/setup-node@v3.8.1
-        with:
-          node-version: 18
           cache: 'pnpm'
+          node-version-file: 'package.json'
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile

.github/workflows/lucide-static.yml

@@ -12,13 +12,11 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v2
+      - uses: pnpm/action-setup@v4
-        with:
-          version: 8
       - uses: actions/setup-node@v4
         with:
-          node-version: 18
           cache: 'pnpm'
+          node-version-file: 'package.json'
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile

.github/workflows/lucide-svelte-5.yml

@@ -0,0 +1,43 @@
+name: Lucide Svelte 5 checks
+
+on:
+  pull_request:
+    paths:
+      - packages/svelte/**
+      - packages/shared/**
+      - tools/build-icons/**
+      - tools/rollup-plugins/**
+      - pnpm-lock.yaml
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with:
+          cache: 'pnpm'
+          node-version-file: 'package.json'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build
+        run: pnpm --filter @lucide/svelte build
+
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with:
+          cache: 'pnpm'
+          node-version-file: 'package.json'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Test
+        run: pnpm --filter @lucide/svelte test

.github/workflows/lucide-svelte.yml

@@ -4,6 +4,7 @@ on:
   pull_request:
     paths:
       - packages/lucide-svelte/**
+      - packages/shared/**
       - tools/build-icons/**
       - tools/rollup-plugins/**
       - pnpm-lock.yaml
@@ -13,13 +14,11 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v2
+      - uses: pnpm/action-setup@v4
-        with:
-          version: 8
       - uses: actions/setup-node@v4
         with:
-          node-version: 18
           cache: 'pnpm'
+          node-version-file: 'package.json'
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
@@ -30,14 +29,12 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v2
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
         with:
-          version: 8
-      - uses: actions/setup-node@v3.8.1
-        with:
-          node-version: 18
           cache: 'pnpm'
+          node-version-file: 'package.json'
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile

.github/workflows/lucide-vue-next.yml

@@ -4,6 +4,7 @@ on:
   pull_request:
     paths:
       - packages/lucide-vue-next/**
+      - packages/shared/**
       - tools/build-icons/**
       - tools/rollup-plugins/**
       - pnpm-lock.yaml
@@ -13,13 +14,11 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v2
+      - uses: pnpm/action-setup@v4
-        with:
-          version: 8
       - uses: actions/setup-node@v4
         with:
-          node-version: 18
           cache: 'pnpm'
+          node-version-file: 'package.json'
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
@@ -30,14 +29,12 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v2
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
         with:
-          version: 8
-      - uses: actions/setup-node@v3.8.1
-        with:
-          node-version: 18
           cache: 'pnpm'
+          node-version-file: 'package.json'
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile

.github/workflows/lucide.yml

@@ -13,13 +13,11 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v2
+      - uses: pnpm/action-setup@v4
-        with:
-          version: 8
       - uses: actions/setup-node@v4
         with:
-          node-version: 18
           cache: 'pnpm'
+          node-version-file: 'package.json'
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
@@ -30,14 +28,12 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v2
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
         with:
-          version: 8
-      - uses: actions/setup-node@v3.8.1
-        with:
-          node-version: 18
           cache: 'pnpm'
+          node-version-file: 'package.json'
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile

.github/workflows/pull-request-icon-preview.yml

@@ -0,0 +1,46 @@
+name: Pull request icon preview
+
+on:
+  pull_request:
+    paths:
+      - 'icons/*.svg'
+
+jobs:
+  generate-changed-icons-comment:
+    name: Generate Changed Icons Comment
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: 'package.json'
+
+      - name: Get changed files
+        id: changed-files
+        uses: tj-actions/changed-files@v46
+        with:
+          files: icons/*.svg
+
+      - uses: actions/setup-node@v4
+      - name: Install svgson for code preview (safer and faster than installing all deps)
+        run: npm install svgson@5.3.1 --force
+
+      - name: Save PR number
+        run: |
+          mkdir -p ./pr
+          echo ${{ github.event.number }} > ./pr/NR
+
+      - name: Generate comment markup
+        run: node ./scripts/generateChangedIconsCommentMarkup.mts >> ./pr/comment-markup.md
+        id: comment-markup
+        env:
+          CHANGED_FILES: ${{ steps.changed-files.outputs.all_changed_files }}
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: pr_number
+          path: pr/

.github/workflows/pull-request-tags-suggestions.yml

@@ -0,0 +1,37 @@
+name: Pull request tags suggestions
+
+on:
+  pull_request_target:
+    paths:
+      - 'icons/*.json'
+
+jobs:
+  pull-request-tags-suggestions:
+    name: Pull Request Tags Suggestions
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+
+    steps:
+      #  We checkout the main branch of main repository for security reasons.
+      #  This is to prevent the workflow from running on a forked repository.
+      - uses: actions/checkout@v4
+        with:
+          repository: lucide-icons/lucide
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with:
+          cache: 'pnpm'
+          node-version-file: 'package.json'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Generate comment markup
+        run: node ./scripts/suggestTags.mts
+        env:
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+          PULL_REQUEST_NUMBER: ${{ github.event.number }}
+          COMMIT_SHA: ${{ github.event.pull_request.head.sha }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/pull-request.yml

@@ -1,123 +0,0 @@
-name: Add Changed Icons comment
-
-on:
-  pull_request_target:
-    paths:
-      - 'icons/*'
-    branches:
-      - main
-      - fix-icon-preview
-
-jobs:
-  lint-filenames:
-    if: github.repository == 'lucide-icons/lucide'
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-          ref: refs/pull/${{ github.event.pull_request.number }}/merge
-      - name: Get changed files
-        id: changed-files
-        uses: tj-actions/changed-files@v41
-        with:
-          files: icons/*
-      - name: Generate annotations
-        run: node ./scripts/lintFilenames.mjs
-        env:
-          CHANGED_FILES: ${{ steps.changed-files.outputs.all_changed_files }}
-
-  lint-contributors:
-    if: github.repository == 'lucide-icons/lucide'
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-          ref: refs/pull/${{ github.event.pull_request.number }}/merge
-      - name: Get changed files
-        id: changed-files
-        uses: tj-actions/changed-files@v41
-        with:
-          files: icons/*
-      - uses: actions/setup-node@v4
-      - name: Install simple-git (safer and faster than installing all deps)
-        run: npm install simple-git
-      - name: Generate annotations
-        run: node ./scripts/updateContributors.mjs
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          FETCH_DEPTH: ${{ github.event.pull_request.commits }}
-          CHANGED_FILES: ${{ steps.changed-files.outputs.all_changed_files }}
-      - name: Generate annotations
-        env:
-          ANNOTATION_SEVERITY: notice
-          ANNOTATION_TITLE: Contributors have changed!
-          ANNOTATION_DESCRIPTION: Don't add people who have only performed automatic optimizations.
-        run: |
-          git diff --unified=0 -- icons/*.json | # diff icon metadata (unified=0 gives the correct chunk line number)
-          perl -ne '/^(\+|- |@)/ && print' | # get chunks (lines that start with "+++", "@@", "+ ", "- ")
-          perl -pe 's/\n/%0A/' | # url encode line breaks (\n -> %0A)
-          perl -pe 's/%0A(\+\+\+ b\/)/\n\1/g' | # split chunks(one chunk per line)
-          perl -pe "s/\+\+\+ b\/([^@]*)%0A@@ -(\d+)[^\s]* \+(\d+)[^@]*@@(.*)/::$ANNOTATION_SEVERITY file=\1,line=\2,endLine=\3,title=$ANNOTATION_TITLE::$ANNOTATION_DESCRIPTION%0A\4/"
-          # Example for the previous substitution
-          # input: +++ b/icons/accessibility.json%0A@@ -2,0 +3 @@%0A+  "contributors": ["hi"],%0A@@ -13 +14 @@%0A+}%0A
-          # output: ::$ANNOTATION_SEVERITY file=icons/accessibility.json,line=2,endLine=3,title=$ANNOTATION_TITLE::$ANNOTATION_DESCRIPTION%0A%0A+  "contributors": ["hi"],%0A@@ -13 +14 @@%0A+}%0A
-
-  lint-aliases:
-    name: Check Uniqueness of Aliases
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-    steps:
-      - uses: actions/checkout@v4
-      - name: Check Uniqueness of Aliases
-        run: "! cat <(printf \"%s\\n\" icons/*.json | while read -r name; do basename \"$name\" .json; done) <(jq -cr 'select(.aliases) | .aliases[] | if type==\"string\" then . else .name end' icons/*.json) | sort | uniq -c | grep -ve '^\\s*1 '"
-
-  generate-changed-icons-comment:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      pull-requests: write
-
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-          ref: refs/pull/${{ github.event.pull_request.number }}/merge
-
-      - name: Get changed files
-        id: changed-files
-        uses: tj-actions/changed-files@v41
-        with:
-          files: icons/*.svg
-
-      - name: Find Comment
-        uses: peter-evans/find-comment@v2
-        id: pr-comment
-        with:
-          issue-number: ${{ github.event.pull_request.number }}
-          comment-author: 'github-actions[bot]'
-          body-includes: Added or changed icons
-
-      - uses: actions/setup-node@v4
-      - name: Install svgson for code preview (safer and faster than installing all deps)
-        run: npm install svgson
-
-      - name: Generate comment markup
-        run: node ./scripts/generateChangedIconsCommentMarkup.mjs >> comment-markup.md
-        id: comment-markup
-        env:
-          CHANGED_FILES: ${{ steps.changed-files.outputs.all_changed_files }}
-
-      - name: Create or update comment
-        uses: peter-evans/create-or-update-comment@v3
-        with:
-          comment-id: ${{ steps.pr-comment.outputs.comment-id }}
-          issue-number: ${{ github.event.pull_request.number }}
-          body-path: ./comment-markup.md
-          edit-mode: replace

.github/workflows/release.yml

@@ -38,6 +38,8 @@ jobs:
     if: github.repository == 'lucide-icons/lucide'
     runs-on: ubuntu-latest
     needs: pre-release
+    permissions:
+      id-token: write
     strategy:
       fail-fast: false
       matrix:
@@ -52,16 +54,16 @@ jobs:
             'lucide-preact',
             'lucide-solid',
             'lucide-svelte',
+            '@lucide/astro',
+            '@lucide/svelte',
           ]
     steps:
       - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v2
+      - uses: pnpm/action-setup@v4
-        with:
-          version: 8
       - uses: actions/setup-node@v4
         with:
-          node-version: 18
           cache: 'pnpm'
+          node-version-file: 'package.json'
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
@@ -79,22 +81,24 @@ jobs:
         run: pnpm --filter ${{ matrix.package }} test
 
       - name: Publish
-        run: pnpm --filter ${{ matrix.package }} publish --no-git-checks --ignore-scripts
+        run: pnpm --filter ${{ matrix.package }} publish --access public --no-git-checks --ignore-scripts
+        env:
+          NPM_CONFIG_PROVENANCE: true
 
   lucide-static:
     if: github.repository == 'lucide-icons/lucide'
     runs-on: ubuntu-latest
     needs: [pre-release, lucide-font]
+    permissions:
+      id-token: write
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/download-artifact@v3
+      - uses: actions/download-artifact@v4
-      - uses: pnpm/action-setup@v2
+      - uses: pnpm/action-setup@v4
-        with:
-          version: 8
       - uses: actions/setup-node@v4
         with:
-          node-version: 18
           cache: 'pnpm'
+          node-version-file: 'package.json'
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
@@ -113,6 +117,8 @@ jobs:
 
       - name: Publish
         run: pnpm --filter lucide-static publish --no-git-checks
+        env:
+          NPM_CONFIG_PROVENANCE: true
 
   lucide-font:
     if: github.repository == 'lucide-icons/lucide'
@@ -120,13 +126,11 @@ jobs:
     needs: pre-release
     steps:
       - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v2
+      - uses: pnpm/action-setup@v4
-        with:
-          version: 8
       - uses: actions/setup-node@v4
         with:
-          node-version: 18
           cache: 'pnpm'
+          node-version-file: 'package.json'
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
@@ -138,7 +142,7 @@ jobs:
         run: pnpm build:font
 
       - name: 'Upload to Artifacts'
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: lucide-font
           path: lucide-font
@@ -150,14 +154,14 @@ jobs:
 
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/download-artifact@v3
+      - uses: actions/download-artifact@v4
       - name: Zip font and icons
         run: |
           zip -r lucide-font-${{ needs.pre-release.outputs.VERSION }}.zip lucide-font
           zip -r lucide-icons-${{ needs.pre-release.outputs.VERSION }}.zip icons
 
       - name: Release zip and fonts
-        uses: softprops/action-gh-release@v1
+        uses: softprops/action-gh-release@v2
         with:
           tag_name: ${{ needs.pre-release.outputs.VERSION }}
           files: |

.github/workflows/request-review.yml

@@ -0,0 +1,32 @@
+name: 'Request Review'
+on:
+  pull_request_target:
+    types: [opened]
+    paths: icons/*.svg
+
+jobs:
+  request-review:
+    if: github.event.pull_request.draft == false
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          ref: refs/pull/${{ github.event.pull_request.number }}/merge
+      - name: Get changed files
+        id: changed-files
+        uses: tj-actions/changed-files@v41
+        with:
+          files: icons/*.svg
+      - run: |
+          while IFS= read -r file; do
+            jq -r '.contributors[]' "${file%.svg}.json"
+          done <<< "$CHANGED_FILES" | while read -r contributor; do
+            gh pr edit "${{ github.event.pull_request.number }}" --add-reviewer "$contributor" || true
+          done
+        env:
+          GH_TOKEN: ${{ github.token }}
+          CHANGED_FILES: ${{ steps.changed-files.outputs.all_changed_files }}

.gitignore

@@ -4,6 +4,7 @@
 .obsidian
 .now
 .idea
+.env
 node_modules
 dist
 build
@@ -16,11 +17,17 @@ outlined
 packages/**/src/icons/*.js
 packages/**/src/icons/*.ts
 packages/**/src/icons/*.tsx
+packages/**/src/aliases/*.ts
 packages/**/src/aliases.ts
+!packages/**/src/aliases/index.ts
 packages/**/src/dynamicIconImports.ts
+packages/**/DynamicIcon.d.ts
 packages/**/dynamicIconImports.js
 packages/**/dynamicIconImports.d.ts
 packages/**/dynamicIconImports.js.map
+packages/**/dynamic.d.ts
+packages/**/dynamic.mjs.map
+packages/**/dynamic.mjs
 packages/**/LICENSE
 categories.json
 tags.json
@@ -39,3 +46,5 @@ docs/.vitepress/data/iconDetails
 docs/.vitepress/data/relatedIcons.json
 docs/.vercel
 docs/.nitro
+.gitignore
+

CONTRIBUTING.md

@@ -16,10 +16,10 @@ Guidelines for pull requests:
 
 - __Make your commit messages as descriptive as possible.__ Include as much information as you can. Explain anything that the file diffs themselves won’t make apparent.
 - __Document your pull request__. Explain your fix, link to the relevant issue, add screenshots when adding new icons.
-- __Make sure the target of your pull request is the relevant branch__. Most of bugfix or new feature should go to the `main` branch.
+- __Make sure the target of your pull request is the relevant branch__. Most of bug fixes or new feature should go to the `main` branch.
-- __Include only related work__. If your pull request has unrelated commit, it won't be accepted.
+- __Include only related work__. If your pull request has unrelated commits, it won't be accepted.
 
-### Pull Requests Including Icons
+### Icon Pull Requests
 
 #### Guidelines
 
@@ -27,26 +27,30 @@ Please make sure you follow the icon guidelines, that should be followed to keep
 
 Read it here: [ICON_GUIDELINES](https://lucide.dev/docs/icon-design-guide).
 
-### Editor guides
+#### Lucide Studio
+
+For formatting and adjusting SVG icons, [@jguddas](https://github.com/jguddas) made a great tool called [Lucide Studio](https://studio.lucide.dev/). It is a web-based SVG editor that allows you to edit and adjust icons in the Lucide style. You can use it to create new icons or modify existing ones.
+
+#### Editor guides
 
 Here you can find instructions on how to implement the guidelines with different vector graphics editors:
 
-#### [Adobe Illustrator Guide](https://lucide.dev/docs/illustrator-guide)
+##### [Adobe Illustrator Guide](https://lucide.dev/docs/illustrator-guide)
 
 You can also [download an Adobe Illustrator template](https://github.com/lucide-icons/lucide/blob/main/docs/public/templates/illustrator_template.ai).
 
-#### [Inkscape Guide](https://lucide.dev/docs/inkscape-guide)
+##### [Inkscape Guide](https://lucide.dev/docs/inkscape-guide)
 
-#### [Figma Guide](https://lucide.dev/docs/figma-guide)
+##### [Figma Guide](https://lucide.dev/docs/figma-guide)
 
-#### [Affinity Designer Guide](https://lucide.dev/guide/design/affinity-designer-guide)
+##### [Affinity Designer Guide](https://lucide.dev/guide/design/affinity-designer-guide)
 
-### Submitting Multiple Icons
+#### Submitting Multiple Icons
 
-If you want submit multiple icons, please separate the icons and group them. That makes reviewing the icons easier and keep the thread clean and scoped.
+If you want to submit multiple icons, please separate the icons and group them. That makes reviewing the icons easier and keeps the thread clean and scoped.
-So don't submit multiple icons in one PR that have noting to do with each other.
+So don't submit multiple icons in one PR that have nothing to do with each other.
 So for example don't create one PR with icons: `arrow-up`, `bicycle`, `arrow-down`.
-Seperate them by two PRs; 'pr-01' `arrow`, `arrow-down` and 'pr-02' `bicycle`.
+Separate them into two PRs; 'pr-01' `arrow`, `arrow-down` and 'pr-02' `bicycle`.
 
 ## Icon Requests
 
@@ -72,12 +76,12 @@ pnpm install # Install dependencies, including the workspace packages
 
 ### Packages -> PNPM Workspaces
 
-To distribute different packages we use PNPM workspaces. Before you start make sure you are familiar with this concept. The concept of working in workspaces is created by Yarn, they have a well written introduction: [yarn workspaces](https://classic.yarnpkg.com/lang/enhttps://lucide.dev/docs/workspaces).
+To distribute different packages we use [PNPM workspaces](https://pnpm.io/workspaces). Before you start make sure you are familiar with this concept. The concept of working in workspaces is created by Yarn, they have a well written introduction: [yarn workspaces](https://classic.yarnpkg.com/en/docs/workspaces).
 
 The configured directory for workspaces is the [packages](https://github.com/lucide-icons/lucide/tree/main/packages) directory, located in the root directory. There you will find all the current packages from lucide.
 There are more workspaces defined, see [`pnpm-workspace.yaml`](https://github.com/lucide-icons/lucide/blob/main/pnpm-workspace.yaml).
 
-> Note: One package is not managed by pnpm:  **lucide-flutter**, this package is written in Dart and used pub for publishing.
+> Note: One package is not managed by pnpm:  **lucide-flutter**, this package is written in Dart and uses pub for publishing.
 
 ### Generated Code
 
@@ -127,7 +131,7 @@ When adding new features to for example the icon component for a framework. It i
 
 ### Local Testing
 
-To test changes in a local project, you can use `yarn link`, `npm link` or `pnpm link` to link the package. Before you do this make sure you builded the package first.
+To test changes in a local project, you can use `yarn link`, `npm link`, `bun link` or `pnpm link` to link the package. Before you do this make sure you've built the package first.
 
 ```sh
 # in packages/lucide-react
@@ -157,6 +161,30 @@ lucide
 
 The lucide.dev website is using [vitepress](https://vitepress.dev/) to generate the static website. The markdown files are located in the docs directory.
 
+#### Running the Docs Website Locally
+
+To test the docs website locally, follow these steps:
+
+1. **Navigate to the docs directory**
+
+```sh
+cd docs
+```
+
+2. **Start the Local Development Server**
+
+```sh
+  pnpm run docs:dev
+```
+
+3. **Open the Website Locally**
+
+Vitepress should open with the following format:
+
+VitePress dev server is running at:
+- **Local**: `http://localhost:3000/`
+- **Network**: `http://192.168.x.x:3000/`
+
 ### Guides
 
 Detailed documentation about: installation, guides, packages, design guides etc.
@@ -165,15 +193,13 @@ Detailed documentation about: installation, guides, packages, design guides etc.
 
 All the icons of lucide in SVG format. These will be used as source for all the packages and other distributions for the lucide icons.
 
-### packages
+### Packages
 
 Includes all the (npm) packages of lucide.
 
-> Note: One package is not managed by pnpm:  **lucide-flutter**, this package is written in Dart and used pub for publishing.
+### Scripts
 
-### scripts
+Includes useful scripts to automate certain jobs. Big part of the scripts is the template generation, for example it generates icon components  for all the packages. These scripts are usually executed from the "scripts" section in the package.json.
-
-Includes usefully scripts to automate certain jobs. Big part of the scripts is the template generation, for example it generates icon components  for all the packages. These scripts are usually executed from the "scripts" section in the package.json.
 
 ## Documentation
 
@@ -190,4 +216,4 @@ If you need any help or have problems with you contribution. Please don't hesita
 Thank you to all the people who already contributed to Lucide!
 
 <a href="https://github.com/lucide-icons/lucide/graphs/contributors">
-<img src="https://opencollective.com/lucide-icons/contributors.svg?width=890" /></a>
+<img src="https://opencollective.com/lucide-icons/contributors.svg?width=800" /></a>

README.md

@@ -8,185 +8,40 @@
 </p>
 <p align="center">
   <a href="https://github.com/lucide-icons/lucide/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/lucide" alt="license"></a>
-  <a href="https://www.npmjs.com/package/lucide"><img src="https://img.shields.io/npm/v/lucide" alt="npm package"></a>
+  <a href="https://www.figma.com/community/plugin/939567362549682242/Lucide-Icons"><img src="https://img.shields.io/badge/Figma-F24E1E?logo=figma&logoColor=white" alt="figma installs"></a>
-  <a href="https://www.figma.com/community/plugin/939567362549682242/Lucide-Icons"><img src="https://img.shields.io/endpoint?logo=figma&label=installs&url=https://yuanqing.github.io/figma-plugins-stats/plugin/939567362549682242/installs.json" alt="figma installs"></a>
   <a href="https://github.com/lucide-icons/lucide/actions/workflows/release.yml"><img src="https://github.com/lucide-icons/lucide/actions/workflows/release.yml/badge.svg" alt="build status"></a>
   <a href="https://discord.gg/EH6nSts"><img src="https://img.shields.io/discord/723074157486800936?label=chat&logo=discord&logoColor=%23ffffff&colorB=%237289DA" alt="discord chat"></a>
 </p>
+<p align="center">
+  <a href="https://lucide.dev/icons/">Icons</a>
+  ·
+  <a href="https://lucide.dev/guide/">Guide</a>
+  ·
+  <a href="https://lucide.dev/packages">Packages</a>
+  ·
+  <a href="https://lucide.dev/license">License</a>
+  ·
+  <a href="https://lucide.dev/showcase">Showcase</a>
+</p>
 
 # Lucide
 
-Community-run fork of [Feather Icons](https://github.com/feathericons/feather), open for anyone to contribute icons.
+Lucide is an open-source icon library that provides 1000+ vector (svg) files for displaying icons and symbols in digital and non-digital projects. The library aims to make it easier for designers and developers to incorporate icons into their projects by providing several official [packages](https://lucide.dev/packages) to make it easier to use these icons in your project.
 
-It began after growing dissatisfaction with the [Feather Icons](https://github.com/feathericons/feather) project moderation. With over 300+ open issues and over 100+ open PRs, the Feather Icons project has been abandoned. This unfortunately means that hundreds of developers and designers wasted their time contributing to Feather Icons with no chance of PRs being accepted.
+## Packages
 
-Lucide is trying to expand the icon set as much as possible while staying faithful to the original simplistic design language. We do this as a community of devs and designers and hope that you'll join us!
+| Logo | Package | Version | Downloads | Links |
-
+| ---- | ------- | ------- | --------- | ----- |
-### Why choose Lucide over Feather Icons
+| <img src="https://lucide.dev/framework-logos/js.svg" alt="JS logo" width="48"> | **`lucide`** | [![npm](https://img.shields.io/npm/v/lucide)](https://www.npmjs.com/package/lucide) | ![NPM Downloads](https://img.shields.io/npm/dw/lucide) | [Docs](https://lucide.dev/guide/packages/lucide) · [Source](./packages/lucide) |
-
+| <img src="https://lucide.dev/framework-logos/react.svg" alt="React logo" width="48"> | **`lucide-react`** | [![npm](https://img.shields.io/npm/v/lucide-react)](https://www.npmjs.com/package/lucide-react) | ![NPM Downloads](https://img.shields.io/npm/dw/lucide-react) | [Docs](https://lucide.dev/guide/packages/lucide-react) · [Source](./packages/lucide-react) |
-- More icons to work with: Lucide already has hundreds of icons more than Feather does.
+| <img src="https://lucide.dev/framework-logos/vue.svg" alt="Vue logo" width="48"> | **`lucide-vue-next`** | [![npm](https://img.shields.io/npm/v/lucide-vue-next)](https://www.npmjs.com/package/lucide-vue-next) | ![NPM Downloads](https://img.shields.io/npm/dw/lucide-vue-next) | [Docs](https://lucide.dev/guide/packages/lucide-vue-next) · [Source](./packages/lucide-vue-next) |
-- Official libraries and integrations with popular frameworks and design tools.
+| <img src="https://lucide.dev/framework-logos/svelte.svg" alt="Svelte logo" width="48"> | **`lucide-svelte`** | [![npm](https://img.shields.io/npm/v/lucide-svelte)](https://www.npmjs.com/package/lucide-svelte) | ![NPM Downloads](https://img.shields.io/npm/dw/lucide-svelte) | [Docs](https://lucide.dev/guide/packages/lucide-svelte) · [Source](./packages/lucide-svelte) |
-- Well maintained code base.
+| <img src="https://lucide.dev/framework-logos/solid.svg" alt="Solid logo" width="48"> | **`lucide-solid`** | [![npm](https://img.shields.io/npm/v/lucide-solid)](https://www.npmjs.com/package/lucide-solid) | ![NPM Downloads](https://img.shields.io/npm/dw/lucide-solid) | [Docs](https://lucide.dev/guide/packages/lucide-solid) · [Source](./packages/lucide-solid) |
-- Active community, regularly growing and improving the set.
+| <img src="https://lucide.dev/framework-logos/preact.svg" alt="Preact logo" width="48"> | **`lucide-preact`** | [![npm](https://img.shields.io/npm/v/lucide-preact)](https://www.npmjs.com/package/lucide-preact) | ![NPM Downloads](https://img.shields.io/npm/dw/lucide-preact) | [Docs](https://lucide.dev/guide/packages/lucide-preact) · [Source](./packages/lucide-preact) |
-
+| <img src="https://lucide.dev/framework-logos/react-native.svg" alt="React Native logo" width="48"> | **`lucide-react-native`** | [![npm](https://img.shields.io/npm/v/lucide-react-native)](https://www.npmjs.com/package/lucide-react-native) | ![NPM Downloads](https://img.shields.io/npm/dw/lucide-react-native) | [Docs](https://lucide.dev/guide/packages/lucide-react-native) · [Source](./packages/lucide-react-native) |
-## Table of Contents
+| <img src="https://lucide.dev/framework-logos/angular.svg" alt="Angular logo" width="48"> | **`lucide-angular`** | [![npm](https://img.shields.io/npm/v/lucide-angular)](https://www.npmjs.com/package/lucide-angular) | ![NPM Downloads](https://img.shields.io/npm/dw/lucide-angular) | [Docs](https://lucide.dev/guide/packages/lucide-angular) · [Source](./packages/lucide-angular) |
-
+| <img src="https://lucide.dev/framework-logos/astro.svg" alt="Astro logo" width="48"> | **`@lucide/astro`** | [![npm](https://img.shields.io/npm/v/@lucide/astro)](https://www.npmjs.com/package/@lucide/astro) | ![NPM Downloads](https://img.shields.io/npm/dw/@lucide/astro) | [Docs](https://lucide.dev/guide/packages/lucide-astro) · [Source](./packages/astro) |
-- [Usage](#usage)
+| <img src="https://lucide.dev/framework-logos/svg.svg" alt="SVG logo" width="48"> | **`lucide-static`** | [![npm](https://img.shields.io/npm/v/lucide-static)](https://www.npmjs.com/package/lucide-static) | ![NPM Downloads](https://img.shields.io/npm/dw/lucide-static) | [Docs](https://lucide.dev/guide/packages/lucide-static) · [Source](./packages/lucide-static) |
-  - [Web](#web)
-  - [React](#react)
-  - [React Native](#react-native)
-  - [Vue 2](#vue-2)
-  - [Vue 3](#vue-3)
-  - [Angular](#angular)
-  - [Preact](#preact)
-  - [Static (svg sprite, font, icons ..)](#static-svg-sprite-font-icons-)
-  - [Figma](#figma)
-  - [Laravel](#laravel)
-  - [Svelte](#svelte)
-  - [Solid](#solid)
-  - [Hyva](#hyva)
-  - [Eleventy](#eleventy)
-- [Contributing](#contributing)
-- [Community](#community)
-- [License](#license)
-- [Credits](#credits)
-- [Sponsors](#sponsors)
-
-## Usage
-
-At its core, Lucide is a collection of [SVG](https://svgontheweb.com/#svg) files. This means that you can use Lucide icons in all the same ways you can use SVGs (e.g. `img`, `background-image`, `inline`, `object`, `embed`, `iframe`). Here's a helpful article detailing the many ways SVGs can be used on the web: [SVG on the Web – Implementation Options](https://svgontheweb.com/#implementation)
-
-The following are additional ways you can use Lucide.
-With the Javascript library you can easily incorporate the icon you want in your webpage.
-
-### Web
-
-Implementation of the lucide icon library for web applications.
-
-```sh
-npm install lucide
-```
-
-or
-
-```sh
-yarn add lucide
-```
-
-For more details, see the [documentation](https://github.com/lucide-icons/lucide/tree/main/packages/lucide#lucide).
-
-### React
-
-Implementation of the lucide icon library for react applications.
-
-```sh
-yarn add lucide-react
-```
-
-or
-
-```sh
-npm install lucide-react
-```
-
-For more details, see the [documentation](https://github.com/lucide-icons/lucide/tree/main/packages/lucide-react#lucide-react).
-
-### React Native
-
-Implementation of the lucide icon library for React Native applications.
-
-```sh
-yarn add lucide-react-native
-```
-
-or
-
-```sh
-npm install lucide-react-native
-```
-
-For more details, see the [documentation](https://github.com/lucide-icons/lucide/tree/main/packages/lucide-react-native#lucide-react-native).
-
-### Vue 2
-
-Implementation of the lucide icon library for vue applications.
-
-```sh
-yarn add lucide-vue
-```
-
-or
-
-```sh
-npm install lucide-vue
-```
-
-For more details, see the [documentation](https://github.com/lucide-icons/lucide/tree/main/packages/lucide-vue#lucide-vue).
-
-### Vue 3
-
-Implementation of the lucide icon library for vue applications.
-
-```sh
-yarn add lucide-vue-next
-```
-
-or
-
-```sh
-npm install lucide-vue-next
-```
-
-For more details, see the [documentation](https://github.com/lucide-icons/lucide/tree/main/packages/lucide-vue-next#lucide-vue-next).
-
-### Angular
-
-```sh
-yarn add lucide-angular
-```
-
-or
-
-```sh
-npm install lucide-angular
-```
-
-For more details, see the [documentation](https://github.com/lucide-icons/lucide/tree/main/packages/lucide-angular#lucide-angular).
-
-### Preact
-
-Implementation of the lucide icon library for preact applications.
-
-```sh
-yarn add lucide-preact
-```
-
-or
-
-```sh
-npm install lucide-preact
-```
-
-For more details, see the [documentation](https://github.com/lucide-icons/lucide/tree/main/packages/lucide-preact#lucide-preact).
-
-### Static (svg sprite, font, icons ..)
-
-Assets:
-[Font Files](https://github.com/lucide-icons/lucide/releases/latest)
-[SVG Files](https://github.com/lucide-icons/lucide/releases/latest)
-[SVG Sprite](https://cdn.jsdelivr.net/npm/lucide-static@latest/sprite.svg)
-
-NPM package
-
-```sh
-yarn add lucide-static
-```
-
-or
-
-```sh
-npm install lucide-static
-```
 
 ### Figma
 
@@ -196,68 +51,6 @@ Visit [Figma community page](https://www.figma.com/community/plugin/939567362549
 
 <img width="420" src="https://www.figma.com/community/plugin/939567362549682242/thumbnail" alt="Figma Lucide Cover">
 
-### Laravel
-
-Implementation of Lucide icon's using `blade-icons` for Laravel based projects.
-
-```sh
-composer require mallardduck/blade-lucide-icons
-```
-
-For more details, see the [documentation](https://github.com/mallardduck/blade-lucide-icons/blob/main/README.md).
-
-### Svelte
-
-Implementation of the lucide icon library for Svelte applications.
-
-```sh
-yarn add lucide-svelte
-```
-
-or
-
-```sh
-npm install lucide-svelte
-```
-
-For more details, see the [documentation](https://github.com/lucide-icons/lucide/tree/main/packages/lucide-svelte#lucide-svelte).
-
-### Solid
-
-Implementation of the lucide icon library for solid applications.
-
-```sh
-yarn add lucide-solid
-```
-
-or
-
-```sh
-npm install lucide-solid
-```
-
-For more details, see the [documentation](https://github.com/lucide-icons/lucide/tree/main/packages/lucide-solid#lucide-solid).
-
-### Hyva
-
-Implementation of Lucide icon's using Hyvä's svg php viewmodal to render icons for Magento 2 Hyva theme based projects.
-
-```sh
-composer require siteation/magento2-hyva-icons-lucide
-```
-
-For more details, see the [documentation](https://github.com/Siteation/magento2-hyva-icons-lucide/blob/main/README.md).
-
-### Eleventy
-
-Using this plugin, Eleventy projects can incorporate Lucide icons. it makes it simple to use Lucide icons into your themes via shortcodes, improving your website's overall usability and visual appeal.
-
-```sh
-npm install @grimlink/eleventy-plugin-lucide-icons
-```
-
-For more details, see the [documentation](https://github.com/GrimLink/eleventy-plugin-lucide-icons/blob/main/README.md).
-
 ## Contributing
 
 For more info on how to contribute please see the [contribution guidelines](https://github.com/lucide-icons/lucide/blob/main/CONTRIBUTING.md).
@@ -270,14 +63,16 @@ Join the community on our [Discord](https://discord.gg/EH6nSts) server!
 
 ## License
 
-Lucide is totally free for commercial use and personally use, this software is licensed under the [ISC License](https://github.com/lucide-icons/lucide/blob/main/LICENSE).
+Lucide is totally free for commercial use and personal use, this software is licensed under the [ISC License](https://github.com/lucide-icons/lucide/blob/main/LICENSE).
 
 ## Credits
 
 Thank you to all the people who contributed to Lucide!
 
 <a href="https://github.com/lucide-icons/lucide/graphs/contributors">
-<img src="https://opencollective.com/lucide-icons/contributors.svg?width=890" /></a>
+
+<img src="https://opencollective.com/lucide-icons/contributors.svg?width=800" />
+</a>
 
 ## Sponsors
 
@@ -287,6 +82,7 @@ Thank you to all the people who contributed to Lucide!
 
 <a href="https://www.digitalocean.com/?refcode=b0877a2caebd&utm_campaign=Referral_Invite&utm_medium=Referral_Program&utm_source=badge"><img src="docs/public/digitalocean.svg" width="200" alt="DigitalOcean Referral Badge" /></a>
 
-### Awesome backer 🍺
+### Awesome backers 🍺
 
 <a href="https://www.scipress.io?utm_source=lucide"><img src="docs/public/sponsors/scipress.svg" width="180" alt="Scipress sponsor badge" /></a>
+<a href="https://github.com/pdfme/pdfme"><img src="docs/public/sponsors/pdfme.svg" width="180" alt="pdfme sponsor badge" /></a>

categories/charts.json

@@ -1,5 +1,5 @@
 {
   "$schema": "../category.schema.json",
   "title": "Charts",
-  "icon": "pie-chart"
+  "icon": "chart-pie"
 }

categories/currency.json

@@ -1,5 +0,0 @@
-{
-  "$schema": "../category.schema.json",
-  "title": "Currency",
-  "icon": "dollar-sign"
-}

categories/finance.json

@@ -1,5 +1,5 @@
 {
   "$schema": "../category.schema.json",
-  "title": "Money",
+  "title": "Finance",
   "icon": "piggy-bank"
 }

categories/furniture.json

@@ -1,5 +0,0 @@
-{
-  "$schema": "../category.schema.json",
-  "title": "Furniture",
-  "icon": "rocking-chair"
-}

categories/maps.json

@@ -1,5 +0,0 @@
-{
-  "$schema": "../category.schema.json",
-  "title": "Maps",
-  "icon": "map"
-}

categories/math.json

@@ -1,5 +1,5 @@
 {
   "$schema": "../category.schema.json",
-  "title": "Maths",
+  "title": "Mathematics",
   "icon": "divide"
 }

categories/notifications.json

@@ -1,5 +1,5 @@
 {
   "$schema": "../category.schema.json",
-  "title": "Notifications",
+  "title": "Notification",
   "icon": "triangle-alert"
 }

docs/.vitepress/api/gh-icon/[...data].get.ts

@@ -13,10 +13,10 @@ export default eventHandler((event) => {
   const data = pathData.at(-1).slice(0, -4);
   const [name] = pathData;
 
-  const src = Buffer.from(data, 'base64')
+  const src = Buffer.from(data, 'base64').toString('utf8').replaceAll('\n', '');
-    .toString('utf8')
+
-    .replaceAll('\n', '')
+  const width = parseInt((src.includes('svg') ? src.match(/width="(\d+)"/)?.[1] : null) ?? '24');
-    .replace(/<svg[^>]*>|<\/svg>/g, '');
+  const height = parseInt((src.includes('svg') ? src.match(/height="(\d+)"/)?.[1] : null) ?? '24');
 
   const children = [];
 
@@ -28,7 +28,7 @@ export default eventHandler((event) => {
     .map((_, idx, arr) => arr.slice(0, idx + 1).join('-'))
     .reverse()
     .find((groupName) => groupName in iconNodes);
-  if (backdropName) {
+  if (!(name in iconNodes) && backdropName) {
     const iconNode = iconNodes[backdropName];
 
     const LucideIcon = createLucideIcon(backdropName, iconNode);
@@ -38,24 +38,26 @@ export default eventHandler((event) => {
     children.push(
       createElement(Backdrop, {
         backdropString,
-        src,
+        src: src.replace(/<svg[^>]*>|<\/svg>/g, ''),
-        color: name in iconNodes ? 'red' : '#777',
+        color: '#777',
       }),
     );
-    if (name in iconNodes) {
-      children.push(
-        createElement(Backdrop, {
-          backdropString: src,
-          src: backdropString,
-          color: 'lime',
-        }),
-      );
-    }
   }
 
   const svg = Buffer.from(
     // We can't use jsx here, is not supported here by nitro.
-    renderToString(createElement(SvgPreview, { src, showGrid: true }, children)),
+    renderToString(
+      createElement(
+        SvgPreview,
+        {
+          src: src.replace(/<svg[^>]*>|<\/svg>/g, ''),
+          height,
+          width,
+          showGrid: true,
+        },
+        children,
+      ),
+    ),
   ).toString('utf8');
 
   defaultContentType(event, 'image/svg+xml');

docs/.vitepress/api/gh-icon/diff/[...data].get.ts

@@ -0,0 +1,37 @@
+import { eventHandler, setResponseHeader, defaultContentType } from 'h3';
+import { renderToString, renderToStaticMarkup } from 'react-dom/server';
+import { createElement } from 'react';
+import Diff from '../../../lib/SvgPreview/Diff.tsx';
+import iconNodes from '../../../data/iconNodes';
+import createLucideIcon from 'lucide-react/src/createLucideIcon';
+
+export default eventHandler((event) => {
+  const { params } = event.context;
+
+  const pathData = params.data.split('/');
+  const data = pathData.at(-1).slice(0, -4);
+  const [name] = pathData;
+
+  const newSrc = Buffer.from(data, 'base64')
+    .toString('utf8')
+    .replaceAll('\n', '')
+    .replace(/<svg[^>]*>|<\/svg>/g, '');
+
+  const children = [];
+
+  const oldSrc = iconNodes[name]
+    ? renderToStaticMarkup(createElement(createLucideIcon(name, iconNodes[name])))
+        .replaceAll('\n', '')
+        .replace(/<svg[^>]*>|<\/svg>/g, '')
+    : '';
+
+  const svg = Buffer.from(
+    // We can't use jsx here, is not supported here by nitro.
+    renderToString(createElement(Diff, { oldSrc, newSrc, showGrid: true }, children)),
+  ).toString('utf8');
+
+  defaultContentType(event, 'image/svg+xml');
+  setResponseHeader(event, 'Cache-Control', 'public,max-age=31536000');
+
+  return svg;
+});

docs/.vitepress/config.ts

@@ -36,6 +36,13 @@ export default defineConfig({
     },
   },
   head: [
+    [
+      'link',
+      {
+        rel: 'preconnect',
+        href: 'https://analytics.lucide.dev',
+      },
+    ],
     [
       'script',
       {

docs/.vitepress/data/categoriesData.json

@@ -35,10 +35,6 @@
     "name": "connectivity",
     "title": "Connectivity"
   },
-  {
-    "name": "currency",
-    "title": "Currency"
-  },
   {
     "name": "cursors",
     "title": "Cursors"
@@ -64,12 +60,12 @@
     "title": "File icons"
   },
   {
-    "name": "food-beverage",
+    "name": "finance",
-    "title": "Food & beverage"
+    "title": "Finance"
   },
   {
-    "name": "furniture",
+    "name": "food-beverage",
-    "title": "Furniture"
+    "title": "Food & beverage"
   },
   {
     "name": "gaming",
@@ -88,21 +84,13 @@
     "title": "Mail"
   },
   {
-    "name": "maps",
+    "name": "math",
-    "title": "Maps"
+    "title": "Mathematics"
-  },
-  {
-    "name": "maths",
-    "title": "Maths"
   },
   {
     "name": "medical",
     "title": "Medical"
   },
-  {
-    "name": "money",
-    "title": "Money"
-  },
   {
     "name": "multimedia",
     "title": "Multimedia"
@@ -117,7 +105,7 @@
   },
   {
     "name": "notifications",
-    "title": "Notifications"
+    "title": "Notification"
   },
   {
     "name": "people",

docs/.vitepress/data/componentLibrariesData.json

@@ -14,5 +14,13 @@
       "light": "/library-logos/tamagui.svg",
       "dark": "/library-logos/tamagui.svg"
     }
+  },
+  {
+    "name": "Reflex",
+    "url": "https://reflex.dev",
+    "image": {
+      "light": "/library-logos/reflex-light.svg",
+      "dark": "/library-logos/reflex-dark.svg"
+    }
   }
 ]

docs/.vitepress/data/packageData.json

@@ -31,24 +31,8 @@
       }
     ]
   },
-  "lucide-vue": {
-    "order": 2,
-    "icon": "vue",
-    "shields": [
-      {
-        "alt": "npm",
-        "src": "https://img.shields.io/npm/v/lucide-vue",
-        "href": "https://www.npmjs.com/package/lucide-vue"
-      },
-      {
-        "alt": "npm",
-        "src": "https://img.shields.io/npm/dw/lucide-vue",
-        "href": "https://www.npmjs.com/package/lucide-vue"
-      }
-    ]
-  },
   "lucide-vue-next": {
-    "order": 3,
+    "order": 2,
     "icon": "vue-next",
     "shields": [
       {
@@ -64,7 +48,7 @@
     ]
   },
   "lucide-svelte": {
-    "order": 4,
+    "order": 3,
     "icon": "svelte",
     "shields": [
       {
@@ -95,24 +79,8 @@
       }
     ]
   },
-  "lucide-preact": {
-    "order": 5,
-    "icon": "preact",
-    "shields": [
-      {
-        "alt": "npm",
-        "src": "https://img.shields.io/npm/v/lucide-preact",
-        "href": "https://www.npmjs.com/package/lucide-preact"
-      },
-      {
-        "alt": "npm",
-        "src": "https://img.shields.io/npm/dw/lucide-preact",
-        "href": "https://www.npmjs.com/package/lucide-preact"
-      }
-    ]
-  },
   "lucide-react-native": {
-    "order": 6,
+    "order": 5,
     "icon": "react-native",
     "shields": [
       {
@@ -128,7 +96,7 @@
     ]
   },
   "lucide-angular": {
-    "order": 7,
+    "order": 6,
     "icon": "angular",
     "shields": [
       {
@@ -143,8 +111,43 @@
       }
     ]
   },
-  "lucide-static": {
+  "lucide-preact": {
+    "order": 7,
+    "icon": "preact",
+    "shields": [
+      {
+        "alt": "npm",
+        "src": "https://img.shields.io/npm/v/lucide-preact",
+        "href": "https://www.npmjs.com/package/lucide-preact"
+      },
+      {
+        "alt": "npm",
+        "src": "https://img.shields.io/npm/dw/lucide-preact",
+        "href": "https://www.npmjs.com/package/lucide-preact"
+      }
+    ]
+  },
+  "@lucide/astro": {
+    "docsAlias": "lucide-astro",
+    "packageDirname": "astro",
     "order": 8,
+    "icon": "astro",
+    "iconDark": "astro-dark",
+    "shields": [
+      {
+        "alt": "npm",
+        "src": "https://img.shields.io/npm/v/@lucide/astro",
+        "href": "https://www.npmjs.com/package/@lucide/astro"
+      },
+      {
+        "alt": "npm",
+        "src": "https://img.shields.io/npm/dw/@lucide/astro",
+        "href": "https://www.npmjs.com/package/@lucide/astro"
+      }
+    ]
+  },
+  "lucide-static": {
+    "order": 9,
     "icon": "svg",
     "shields": [
       {

docs/.vitepress/data/packageData.thirdParty.json

@@ -76,5 +76,24 @@
     ],
     "source": "https://github.com/swisnl/nuxt-lucide-icons",
     "documentation": "https://github.com/swisnl/nuxt-lucide-icons/blob/main/README.md"
+  },
+    {
+    "name": "lucide-lustre",
+    "description": "A library providing https://lucide.dev icons to lustre.",
+    "icon": "/framework-logos/lustre.webp",
+    "shields": [
+      {
+        "alt": "Latest Stable Version",
+        "src": "https://img.shields.io/hexpm/v/lucide_lustre",
+        "href": "https://hex.pm/packages/lucide_lustre"
+      },
+      {
+        "alt": "Total Downloads",
+        "src": "https://img.shields.io/hexpm/dw/lucide_lustre",
+        "href": "https://hex.pm/packages/lucide_lustre"
+      }
+    ],
+    "source": "https://github.com/dinkelspiel/lucide_lustre",
+    "documentation": "https://github.com/dinkelspiel/lucide_lustre/blob/master/README.md"
   }
 ]

docs/.vitepress/data/teamData.json

@@ -11,7 +11,7 @@
       },
       {
         "icon": "x",
-        "link": "https://github.com/ericfennis"
+        "link": "https://x.com/ericfennis"
       }
     ]
   },

docs/.vitepress/lib/SvgPreview/Backdrop.tsx

@@ -3,10 +3,16 @@ import React from 'react';
 interface BackdropProps {
   src: string;
   color?: string;
+  outline?: boolean;
   backdropString: string;
 }
 
-const Backdrop = ({ src, color = 'red', backdropString }: BackdropProps): JSX.Element => {
+const Backdrop = ({
+  src,
+  color = 'red',
+  outline = true,
+  backdropString,
+}: BackdropProps): JSX.Element => {
   const id = React.useId();
   return (
     <>
@@ -73,13 +79,15 @@ const Backdrop = ({ src, color = 'red', backdropString }: BackdropProps): JSX.El
           opacity={0.75}
           dangerouslySetInnerHTML={{ __html: src }}
         />
-        <g
+        {outline && (
-          stroke={color}
+          <g
-          strokeWidth={2.25}
+            stroke={color}
-          opacity={0.75}
+            strokeWidth={2.25}
-          mask={`url(#svg-preview-backdrop-mask-outline-${id})`}
+            opacity={0.75}
-          dangerouslySetInnerHTML={{ __html: backdropString }}
+            mask={`url(#svg-preview-backdrop-mask-outline-${id})`}
-        />
+            dangerouslySetInnerHTML={{ __html: backdropString }}
+          />
+        )}
       </g>
     </>
   );

docs/.vitepress/lib/SvgPreview/Diff.tsx

@@ -0,0 +1,71 @@
+import React from 'react';
+import Backdrop from './Backdrop.tsx';
+import { darkModeCss, Grid } from './index.tsx';
+
+const SvgPreview = React.forwardRef<
+  SVGSVGElement,
+  {
+    oldSrc: string;
+    newSrc: string;
+  } & React.SVGProps<SVGSVGElement>
+>(({ oldSrc, newSrc, children, ...props }, ref) => {
+  return (
+    <svg
+      ref={ref}
+      xmlns="http://www.w3.org/2000/svg"
+      width={24}
+      height={24}
+      viewBox="0 0 24 24"
+      fill="none"
+      stroke="currentColor"
+      strokeWidth={2}
+      strokeLinecap="round"
+      strokeLinejoin="round"
+      {...props}
+    >
+      <style>{darkModeCss}</style>
+      <Grid
+        strokeWidth={0.1}
+        stroke="#777"
+        strokeOpacity={0.3}
+        radius={1}
+      />
+      <mask
+        id="gray"
+        maskUnits="userSpaceOnUse"
+      >
+        <rect
+          x="0"
+          y="0"
+          width="24"
+          height="24"
+          fill="#000"
+          stroke="none"
+        />
+        <g
+          stroke="#fff"
+          dangerouslySetInnerHTML={{ __html: oldSrc }}
+        />
+      </mask>
+      <Backdrop
+        src=""
+        outline={false}
+        backdropString={`<g mask="url('#gray')">${newSrc}</g>`}
+        color="#777"
+      />
+      <Backdrop
+        src={oldSrc}
+        backdropString={newSrc}
+        color="lime"
+      />
+      <Backdrop
+        src={newSrc}
+        backdropString={oldSrc}
+        color="red"
+      />
+      {children}
+    </svg>
+  );
+});
+
+export default SvgPreview;

docs/.vitepress/lib/SvgPreview/GapViolationHighlight.tsx

@@ -0,0 +1,137 @@
+import React from 'react';
+import pathToPoints from './path-to-points';
+import { Path, PathProps } from './types';
+
+export const GapViolationHighlight = ({
+  radius,
+  stroke,
+  strokeWidth,
+  strokeOpacity,
+  paths,
+  ...props
+}: {
+  paths: Path[];
+} & PathProps<'stroke' | 'strokeOpacity' | 'strokeWidth', 'd'>) => {
+  const id = React.useId();
+
+  const groupedPaths = Object.entries(
+    paths.reduce(
+      (groups, val) => {
+        const key = val.c.id;
+        groups[key] = [...(groups[key] || []), val];
+        return groups;
+      },
+      {} as Record<number, Path[]>,
+    ),
+  );
+
+  const groups: Group[] = [];
+
+  for (const [, paths] of groupedPaths) {
+    const d = paths.map((path) => path.d).join(' ');
+    const points = paths.flatMap((path) => pathToPoints(path));
+    groups.push({ id: d, points });
+  }
+
+  const mergedGroups = mergeGroups(groups, 2);
+
+  return (
+    <g {...props}>
+      <defs xmlns="http://www.w3.org/2000/svg">
+        <pattern
+          id={`backdrop-pattern-${id}`}
+          width=".1"
+          height=".1"
+          patternUnits="userSpaceOnUse"
+          patternTransform="rotate(45 50 50)"
+        >
+          <line
+            stroke={stroke}
+            strokeWidth={0.1}
+            y2={1}
+          />
+          <line
+            stroke={stroke}
+            strokeWidth={0.1}
+            y2={1}
+          />
+        </pattern>
+      </defs>
+      {mergedGroups.flatMap((ds, idx, arr) =>
+        arr.slice(0, idx).map((val, i) => (
+          <g
+            strokeWidth={strokeWidth}
+            key={i}
+          >
+            <mask
+              id={`svg-preview-backdrop-mask-${id}-${i}`}
+              maskUnits="userSpaceOnUse"
+            >
+              <path
+                stroke="white"
+                d={val.join(' ')}
+              />
+            </mask>
+            <path
+              d={ds.join(' ')}
+              stroke={`url(#backdrop-pattern-${id})`}
+              strokeWidth={strokeWidth}
+              strokeOpacity={strokeOpacity}
+              mask={`url(#svg-preview-backdrop-mask-${id}-${i})`}
+            />
+          </g>
+        )),
+      )}
+    </g>
+  );
+};
+
+type Point = { x: number; y: number };
+type Group = { id: string; points: Point[] };
+
+// Euclidean distance
+function distance(a: Point, b: Point): number {
+  return Math.hypot(a.x - b.x, a.y - b.y);
+}
+
+// Check if two groups should be merged based on minimum distance
+function shouldMerge(a: Group, b: Group, minDistance: number): boolean {
+  for (const pa of a.points) {
+    for (const pb of b.points) {
+      if (distance(pa, pb) <= minDistance) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+
+// Merge groups and return arrays of merged group IDs
+function mergeGroups(groups: Group[], minDistance: number): string[][] {
+  const mergedGroups: Group[][] = groups.map((g) => [g]);
+
+  let changed = true;
+  while (changed) {
+    changed = false;
+
+    outer: for (let i = 0; i < mergedGroups.length; i++) {
+      for (let j = i + 1; j < mergedGroups.length; j++) {
+        // Check if any group in mergedGroups[i] should merge with any in mergedGroups[j]
+        if (
+          mergedGroups[i].some((ga) =>
+            mergedGroups[j].some((gb) => shouldMerge(ga, gb, minDistance)),
+          )
+        ) {
+          // Merge group j into group i
+          mergedGroups[i] = [...mergedGroups[i], ...mergedGroups[j]];
+          mergedGroups.splice(j, 1);
+          changed = true;
+          break outer;
+        }
+      }
+    }
+  }
+
+  // Return only arrays of IDs
+  return mergedGroups.map((groupList) => groupList.map((g) => g.id));
+}

docs/.vitepress/lib/SvgPreview/index.tsx

@@ -1,13 +1,36 @@
 import React from 'react';
 import { PathProps, Path } from './types';
-import { getPaths, assert } from './utils';
+import getPaths, { assert } from './utils';
+import { GapViolationHighlight } from './GapViolationHighlight.tsx';
 
-const Grid = ({
+export const darkModeCss = `
+  @media screen and (prefers-color-scheme: light) {
+    .svg-preview-grid-rect { fill: none }
+  }
+  @media screen and (prefers-color-scheme: dark) {
+    .svg-preview-grid-rect { fill: none }
+    .svg
+    .svg-preview-grid-group,
+    .svg-preview-radii-group,
+    .svg-preview-shadow-mask-group,
+    .svg-preview-shadow-group {
+      stroke: #fff;
+    }
+  }
+`;
+
+export const Grid = ({
   radius,
-  fill = '#fff',
+  fill,
+  height,
+  width,
+  subGridSize = 0,
   ...props
 }: {
+  height: number;
+  width: number;
   strokeWidth: number;
+  subGridSize?: number;
   radius: number;
 } & PathProps<'stroke', 'strokeWidth'>) => (
   <g
@@ -17,43 +40,53 @@ const Grid = ({
   >
     <rect
       className="svg-preview-grid-rect"
-      width={24 - props.strokeWidth}
+      width={width - props.strokeWidth}
-      height={24 - props.strokeWidth}
+      height={height - props.strokeWidth}
       x={props.strokeWidth / 2}
       y={props.strokeWidth / 2}
       rx={radius}
       fill={fill}
     />
     <path
-      strokeDasharray={'0 0.1 ' + '0.1 0.15 '.repeat(11) + '0 0.15'}
+      strokeDasharray={
+        '0 0.1 ' + '0.1 0.15 '.repeat(subGridSize ? subGridSize * 4 - 1 : 95) + '0 0.15'
+      }
       strokeWidth={0.1}
       d={
         props.d ||
-        new Array(Math.floor(24 - 1))
+        [
-          .fill(null)
+          ...new Array(Math.floor(width - 1))
-          .map((_, i) => i)
+            .fill(null)
-          .filter((i) => i % 3 !== 2)
+            .map((_, i) => i)
-          .flatMap((i) => [
+            .filter((i) => !subGridSize || i % subGridSize !== subGridSize - 1)
-            `M${props.strokeWidth} ${i + 1}h${24 - props.strokeWidth * 2}`,
+            .flatMap((i) => [`M${i + 1} ${props.strokeWidth}v${height - props.strokeWidth * 2}`]),
-            `M${i + 1} ${props.strokeWidth}v${24 - props.strokeWidth * 2}`,
+          ...new Array(Math.floor(height - 1))
-          ])
+            .fill(null)
-          .join('')
+            .map((_, i) => i)
-      }
+            .filter((i) => !subGridSize || i % subGridSize !== subGridSize - 1)
-    />
+            .flatMap((i) => [`M${props.strokeWidth} ${i + 1}h${width - props.strokeWidth * 2}`]),
-    <path
+        ].join('')
-      d={
-        props.d ||
-        new Array(Math.floor(24 - 1))
-          .fill(null)
-          .map((_, i) => i)
-          .filter((i) => i % 3 === 2)
-          .flatMap((i) => [
-            `M${props.strokeWidth} ${i + 1}h${24 - props.strokeWidth * 2}`,
-            `M${i + 1} ${props.strokeWidth}v${24 - props.strokeWidth * 2}`,
-          ])
-          .join('')
       }
     />
+    {!!subGridSize && (
+      <path
+        d={
+          props.d ||
+          [
+            ...new Array(Math.floor(width - 1))
+              .fill(null)
+              .map((_, i) => i)
+              .filter((i) => i % subGridSize === subGridSize - 1)
+              .flatMap((i) => [`M${i + 1} ${props.strokeWidth}v${height - props.strokeWidth * 2}`]),
+            ...new Array(Math.floor(height - 1))
+              .fill(null)
+              .map((_, i) => i)
+              .filter((i) => i % subGridSize === subGridSize - 1)
+              .flatMap((i) => [`M${props.strokeWidth} ${i + 1}h${width - props.strokeWidth * 2}`]),
+          ].join('')
+        }
+      />
+    )}
   </g>
 );
 
@@ -83,6 +116,7 @@ const Shadow = ({
       >
         {groupedPaths.map(([id, paths]) => (
           <mask
+            key={`svg-preview-shadow-mask-${id}`}
             id={`svg-preview-shadow-mask-${id}`}
             maskUnits="userSpaceOnUse"
             strokeOpacity="1"
@@ -92,8 +126,8 @@ const Shadow = ({
             <rect
               x={0}
               y={0}
-              width={24}
+              width="100%"
-              height={24}
+              height="100%"
               fill="#fff"
               stroke="none"
               rx={radius}
@@ -136,30 +170,34 @@ const ColoredPath = ({
   colors,
   paths,
   ...props
-}: { paths: Path[]; colors: string[] } & PathProps<never, 'd' | 'stroke'>) => (
+}: { paths: Path[]; colors: string[] } & PathProps<never, 'd' | 'stroke'>) => {
-  <g
+  let idx = 0;
-    className="svg-preview-colored-path-group"
+  return (
-    {...props}
+    <g
-  >
+      className="svg-preview-colored-path-group"
-    {paths.map(({ d, c }, i) => (
+      {...props}
-      <path
+    >
-        key={i}
+      {paths.map(({ d, c }, i) => (
-        d={d}
+        <path
-        stroke={colors[(c.name === 'path' ? i : c.id) % colors.length]}
+          key={i}
-      />
+          d={d}
-    ))}
+          stroke={colors[(c.name === 'path' ? idx++ : c.id) % colors.length]}
-  </g>
+        />
-);
+      ))}
+    </g>
+  );
+};
 
 const ControlPath = ({
   paths,
   radius,
   pointSize,
   ...props
-}: { pointSize: number; paths: Path[]; radius: number } & PathProps<
+}: {
-  'stroke' | 'strokeWidth',
+  pointSize: number;
-  'd'
+  paths: Path[];
->) => {
+  radius: number;
+} & PathProps<'stroke' | 'strokeWidth', 'd'>) => {
   const controlPaths = paths.map((path, i) => {
     const element = paths.filter((p) => p.c.id === path.c.id);
     const lastElement = element.at(-1)?.next;
@@ -191,8 +229,8 @@ const ControlPath = ({
                 <rect
                   x="0"
                   y="0"
-                  width="24"
+                  width="100%"
-                  height="24"
+                  height="100%"
                   fill="#fff"
                   stroke="none"
                   rx={radius}
@@ -227,7 +265,7 @@ const ControlPath = ({
             )
             .join('')}
         />
-        {controlPaths.map(({ d, prev, next, startMarker, endMarker }, i) => (
+        {controlPaths.map(({ prev, next, startMarker, endMarker }, i) => (
           <React.Fragment key={i}>
             {startMarker && (
               <circle
@@ -263,11 +301,37 @@ const Radii = ({
       {...props}
     >
       {paths.map(
-        ({ c, prev, next, circle }, i) =>
+        ({ circle, next, prev, c }, i) =>
           circle && (
             <React.Fragment key={i}>
-              {c.name !== 'circle' && (
+              {circle.tangentIntersection && c.name === 'path' && (
-                <path d={`M${prev.x} ${prev.y} ${circle.x} ${circle.y} ${next.x} ${next.y}`} />
+                <>
+                  <circle
+                    cx={next.x * 2 - circle.tangentIntersection.x}
+                    cy={next.y * 2 - circle.tangentIntersection.y}
+                    r={0.25}
+                  />
+                  <circle
+                    cx={prev.x * 2 - circle.tangentIntersection.x}
+                    cy={prev.y * 2 - circle.tangentIntersection.y}
+                    r={0.25}
+                  />
+                  <path
+                    d={`M${next.x * 2 - circle.tangentIntersection.x} ${
+                      next.y * 2 - circle.tangentIntersection.y
+                    }L${circle.tangentIntersection.x} ${circle.tangentIntersection.y}L${prev.x * 2 - circle.tangentIntersection.x} ${
+                      prev.y * 2 - circle.tangentIntersection.y
+                    }`}
+                  />
+                  <circle
+                    cx={circle.tangentIntersection.x}
+                    cy={circle.tangentIntersection.y}
+                    r={0.25}
+                  />
+                </>
+              )}
+              {c.name === 'path' && (
+                <path d={`M${next.x} ${next.y}L${circle.x} ${circle.y}L${prev.x} ${prev.y}`} />
               )}
               <circle
                 cy={circle.y}
@@ -297,68 +361,60 @@ const Radii = ({
 const Handles = ({
   paths,
   ...props
-}: { paths: Path[] } & PathProps<
+}: { paths: Path[] } & PathProps<'strokeWidth' | 'stroke' | 'strokeOpacity', any>) => (
-  'strokeWidth' | 'stroke' | 'strokeDasharray' | 'strokeOpacity',
+  <g
-  any
+    className="svg-preview-handles-group"
->) => {
+    {...props}
-  return (
+  >
-    <g
+    {paths.map(({ c, prev, next, cp1, cp2 }, i) => (
-      className="svg-preview-handles-group"
+      <React.Fragment key={i}>
-      {...props}
+        {cp1 && <path d={`M${prev.x} ${prev.y} ${cp1.x} ${cp1.y}`} />}
-    >
+        {cp1 && (
-      {paths.map(({ c, prev, next, cp1, cp2 }) => (
+          <circle
-        <>
+            cy={cp1.y}
-          {cp1 && <path d={`M${prev.x} ${prev.y} ${cp1.x} ${cp1.y}`} />}
+            cx={cp1.x}
-          {cp1 && (
+            r={0.25}
-            <circle
+          />
-              cy={cp1.y}
+        )}
-              cx={cp1.x}
+        {cp2 && <path d={`M${next.x} ${next.y} ${cp2.x} ${cp2.y}`} />}
-              r={0.25}
+        {cp2 && (
-            />
+          <circle
-          )}
+            cy={cp2.y}
-          {cp2 && <path d={`M${next.x} ${next.y} ${cp2.x} ${cp2.y}`} />}
+            cx={cp2.x}
-          {cp2 && (
+            r={0.25}
-            <circle
+          />
-              cy={cp2.y}
+        )}
-              cx={cp2.x}
+      </React.Fragment>
-              r={0.25}
+    ))}
-            />
+  </g>
-          )}
+);
-        </>
-      ))}
-    </g>
-  );
-};
 
 const SvgPreview = React.forwardRef<
   SVGSVGElement,
   {
+    height?: number;
+    width?: number;
     src: string | ReturnType<typeof getPaths>;
     showGrid?: boolean;
   } & React.SVGProps<SVGSVGElement>
->(({ src, children, showGrid = false, ...props }, ref) => {
+>(({ src, children, height = 24, width = 24, showGrid = false, ...props }, ref) => {
+  const subGridSize =
+    Math.max(height, width) % 3 === 0
+      ? Math.max(height, width) > 24
+        ? 12
+        : 3
+      : Math.max(height, width) % 5 === 0
+        ? 5
+        : 0;
   const paths = typeof src === 'string' ? getPaths(src) : src;
 
-  const darkModeCss = `@media screen and (prefers-color-scheme: light) {
-  .svg-preview-grid-rect { fill: none }
-}
-@media screen and (prefers-color-scheme: dark) {
-  .svg-preview-grid-rect { fill: none }
-  .svg
-  .svg-preview-grid-group,
-  .svg-preview-radii-group,
-  .svg-preview-shadow-mask-group,
-  .svg-preview-shadow-group {
-    stroke: #fff;
-  }
-}`;
   return (
     <svg
       ref={ref}
       xmlns="http://www.w3.org/2000/svg"
-      width={24}
+      width={width}
-      height={24}
+      height={height}
-      viewBox="0 0 24 24"
+      viewBox={`0 0 ${width} ${height}`}
       fill="none"
       stroke="currentColor"
       strokeWidth={2}
@@ -369,8 +425,12 @@ const SvgPreview = React.forwardRef<
       <style>{darkModeCss}</style>
       {showGrid && (
         <Grid
+          height={height}
+          width={width}
+          subGridSize={subGridSize}
           strokeWidth={0.1}
           stroke="#777"
+          mask="url(#svg-preview-bounding-box-mask)"
           strokeOpacity={0.3}
           radius={1}
         />
@@ -382,6 +442,12 @@ const SvgPreview = React.forwardRef<
         radius={1}
         strokeOpacity={0.15}
       />
+      <GapViolationHighlight
+        paths={paths}
+        stroke="red"
+        strokeOpacity={0.75}
+        strokeWidth={4}
+      />
       <Handles
         paths={paths}
         strokeWidth={0.12}
@@ -430,4 +496,6 @@ const SvgPreview = React.forwardRef<
   );
 });
 
+SvgPreview.displayName = 'SvgPreview';
+
 export default SvgPreview;

docs/.vitepress/lib/SvgPreview/path-to-points.ts

@@ -0,0 +1,19 @@
+import memoize from 'lodash/memoize';
+import SVGPathCommander from 'svg-path-commander';
+import { Path } from './types';
+
+function pathToPoints({ d, prev, next }: Path, interval = 1) {
+  const commander = new SVGPathCommander(d);
+  const points = [];
+  try {
+    const totalLength = commander.getTotalLength();
+    points.push(prev);
+    for (let i = interval; i < totalLength - interval; i += interval) {
+      points.push(commander.getPointAtLength(i));
+    }
+    points.push(next);
+  } catch (err) {}
+  return points;
+}
+
+export default memoize(pathToPoints);

docs/.vitepress/lib/SvgPreview/utils.ts

@@ -1,7 +1,10 @@
 import { INode, parseSync } from 'svgson';
+// @ts-ignore
 import toPath from 'element-to-path';
+// @ts-ignore
 import { SVGPathData, encodeSVGPath } from 'svg-pathdata';
 import { Path, Point } from './types';
+import memoize from 'lodash/memoize';
 
 function assertNever(x: never): never {
   throw new Error('Unknown type: ' + x['type']);
@@ -44,17 +47,21 @@ const extractNodes = (node: INode): INode[] => {
   return [];
 };
 
-export const getNodes = (src: string) =>
+export const getNodes = memoize((src: string) =>
-  extractNodes(parseSync(src.includes('<svg') ? src : `<svg>${src}</svg>`));
+  extractNodes(parseSync(src.includes('<svg') ? src : `<svg>${src}</svg>`)),
+);
 
 export const getCommands = (src: string) =>
   getNodes(src)
     .map(convertToPathNode)
     .flatMap(({ d, name }, idx) =>
-      new SVGPathData(d).toAbs().commands.map((c, cIdx) => ({ ...c, id: idx, idx: cIdx, name })),
+      new SVGPathData(d)
+        .toAbs()
+        // @ts-ignore
+        .commands.map((c, cIdx) => ({ ...c, id: idx, idx: cIdx, name })),
     );
 
-export const getPaths = (src: string) => {
+const getPaths = (src: string) => {
   const commands = getCommands(src.includes('<svg') ? src : `<svg>${src}</svg>`);
   const paths: Path[] = [];
   let prev: Point | undefined = undefined;
@@ -237,6 +244,7 @@ export const getPaths = (src: string) => {
         break;
       }
       default: {
+        // @ts-ignore
         assertNever(c);
       }
     }
@@ -244,7 +252,7 @@ export const getPaths = (src: string) => {
   return paths;
 };
 
-export const arcEllipseCenter = (
+const arcEllipseCenter = (
   x1: number,
   y1: number,
   rx: number,
@@ -296,5 +304,52 @@ export const arcEllipseCenter = (
     M2[1][0] * Cp[0] + M2[1][1] * Cp[1] + V3[1],
   ];
 
-  return { x: C[0], y: C[1] };
+  return {
+    x: C[0],
+    y: C[1],
+    tangentIntersection: intersectTangents(
+      { x: x1, y: y1 },
+      { x: x2, y: y2 },
+      { x: C[0], y: C[1] },
+    ),
+  };
 };
+
+function getTangentDirection(p: Point, center: Point): Point {
+  // Tangent is perpendicular to the radius vector (rotate radius 90°)
+  const dx = p.x - center.x;
+  const dy = p.y - center.y;
+  return { x: -dy, y: dx }; // 90° rotation
+}
+
+function intersectTangents(start: Point, end: Point, center: Point): Point | null {
+  const t1 = getTangentDirection(start, center);
+  const t2 = getTangentDirection(end, center);
+
+  // Solve: start + λ * t1 = end + μ * t2
+  const A = [
+    [t1.x, -t2.x],
+    [t1.y, -t2.y],
+  ];
+  const b = [end.x - start.x, end.y - start.y];
+
+  // Compute determinant
+  const det = A[0][0] * A[1][1] - A[0][1] * A[1][0];
+
+  if (Math.abs(det) < 1e-10) {
+    // Lines are parallel, no intersection
+    return null;
+  }
+
+  const invDet = 1 / det;
+
+  const lambda = (b[0] * A[1][1] - b[1] * A[0][1]) * invDet;
+
+  // Intersection point = start + lambda * t1
+  return {
+    x: start.x + lambda * t1.x,
+    y: start.y + lambda * t1.y,
+  };
+}
+
+export default memoize(getPaths);

docs/.vitepress/lib/codeExamples/createCodeExamples.ts

@@ -1,5 +1,4 @@
-import { bundledLanguages, type ThemeRegistration } from 'shikiji';
+import { bundledLanguages, getHighlighter, type ThemeRegistration } from 'shikiji';
-import { getHighlighter } from 'shikiji';
 
 type CodeExampleType = {
   title: string;
@@ -102,13 +101,8 @@ import { LucideAngularModule, $PascalCase } from 'lucide-angular';
     },
     {
       language: 'html',
-      title: 'Icon Font',
+      title: 'Icon font',
-      code: `<style>
+      code: `<div class="icon-$Name"></div>`,
-@import ('~lucide-static/font/Lucide.css');
-</style>
-
-<div class="icon-$Name"></div>
-`,
     },
   ];
 };

docs/.vitepress/lib/codeExamples/createLabCodeExamples.ts

@@ -49,7 +49,7 @@ import { $CamelCase } from '@lucide/lab';
 </script>
 
 <template>
-  <Icon :iconNode="burger" />
+  <Icon :iconNode="$CamelCase" />
 </template>
 `,
     },
@@ -61,7 +61,7 @@ import { Icon } from 'lucide-svelte';
 import { $CamelCase } from '@lucide/lab';
 </script>
 
-<Icon iconNode={burger} />
+<Icon iconNode={$CamelCase} />
 `,
     },
     {

docs/.vitepress/sidebar.ts

@@ -46,6 +46,10 @@ const sidebar: UserConfig<DefaultTheme.Config>['themeConfig']['sidebar'] = {
           text: 'Filled icons',
           link: '/guide/advanced/filled-icons',
         },
+        {
+          text: 'Aliased Names',
+          link: '/guide/advanced/aliased-names',
+        },
         // {
         //   text: 'Combining icons',
         // },
@@ -68,10 +72,6 @@ const sidebar: UserConfig<DefaultTheme.Config>['themeConfig']['sidebar'] = {
           text: 'Lucide React',
           link: '/guide/packages/lucide-react',
         },
-        {
-          text: 'Lucide React Native',
-          link: '/guide/packages/lucide-react-native',
-        },
         {
           text: 'Lucide Vue',
           link: '/guide/packages/lucide-vue-next',
@@ -85,13 +85,21 @@ const sidebar: UserConfig<DefaultTheme.Config>['themeConfig']['sidebar'] = {
           link: '/guide/packages/lucide-solid',
         },
         {
-          text: 'Lucide Preact',
+          text: 'Lucide React Native',
-          link: '/guide/packages/lucide-preact',
+          link: '/guide/packages/lucide-react-native',
         },
         {
           text: 'Lucide Angular',
           link: '/guide/packages/lucide-angular',
         },
+        {
+          text: 'Lucide Preact',
+          link: '/guide/packages/lucide-preact',
+        },
+        {
+          text: 'Lucide Astro',
+          link: '/guide/packages/lucide-astro',
+        },
         {
           text: 'Lucide Static',
           link: '/guide/packages/lucide-static',

docs/.vitepress/theme/components/base/InputSearch.vue

@@ -38,6 +38,7 @@ const value = computed({
   <Input
     ref="input"
     type="search"
+    autofocus
     v-bind="$attrs"
     v-model="value"
     class="input-wrapper"

docs/.vitepress/theme/components/base/Switch.vue

@@ -1,15 +1,22 @@
 <script setup>
-  import { ref } from 'vue'
   import { Switch } from '@headlessui/vue'
 
-  const enabled = ref(false)
+  defineProps({
+    modelValue: {
+      type: Boolean,
+      default: false
+    }
+  })
+
+  const emit = defineEmits(['update:modelValue'])
 </script>
 
 <template>
   <Switch
-    v-model="enabled"
+    :model-value="modelValue"
+    @update:model-value="emit('update:modelValue', $event)"
     class="switch"
-    :class="{ enabled }"
+    :class="{ enabled: modelValue }"
   >
     <span class="thumb" />
   </Switch>

docs/.vitepress/theme/components/base/Tooltip.vue

@@ -42,7 +42,7 @@ onMounted(() => {
   font-weight: 400;
   background: var(--vp-c-brand-dark);
   color: white;
-  z-index: 10;
+  z-index: 99;
   white-space: nowrap;
   padding: 2px 8px;
   border-radius: 4px;

docs/.vitepress/theme/components/home/HomeHeroBefore.data.ts

@@ -9,7 +9,7 @@ export default {
         }
         return null;
       })
-      .then((res) => res.tag_name);
+      .then((res) => res?.tag_name);
 
     return {
       version,

docs/.vitepress/theme/components/home/HomeIconCustomizer.vue

@@ -48,6 +48,7 @@ function resetStyle () {
   color.value = 'currentColor'
   strokeWidth.value = 2
   size.value = 24
+  absoluteStrokeWidth.value = false
 }
 
 watch(absoluteStrokeWidth, (enabled) => {
@@ -171,16 +172,14 @@ watch(absoluteStrokeWidth, (enabled) => {
   margin-top: 32px;
   padding: 0;
   background: none;
-  max-width: 280px;
 }
 
 @media (min-width: 640px) {
-
   .card {
     display: grid;
     grid-template-columns: 8fr 10fr;
   }
-/*
+  /*
   .card-column {
     flex: 1;
   } */

docs/.vitepress/theme/components/home/HomePackagesSection.data.ts

@@ -37,6 +37,12 @@ export default {
           logo: '/framework-logos/angular.svg',
           label: 'Lucide documentation for Angular',
         },
+        {
+          name: 'lucide-astro',
+          logo: '/framework-logos/astro.svg',
+          logoDark: '/framework-logos/astro-dark.svg',
+          label: 'Lucide documentation for Astro',
+        },
         {
           name: 'lucide-react-native',
           logo: '/framework-logos/react-native.svg',

docs/.vitepress/theme/components/home/HomePackagesSection.vue

@@ -13,7 +13,7 @@ const { go } = useRouter()
     <HomeSectionTitle>Available For:</HomeSectionTitle>
     <div class="packages-list">
       <a
-        v-for="{ name, logo } in data.packages"
+        v-for="{ name, logo, logoDark } in data.packages"
         :href="`/guide/packages/${name}`"
         class="package-logo"
         :aria-label="`Read more about: ${name} package`"
@@ -21,10 +21,17 @@ const { go } = useRouter()
       >
         <img
           :src="logo"
-          height="36"
+          :class="{ light: logoDark, 'image-logo': true }"
-          width="36"
-          loading="lazy"
           :alt="`${name} logo`"
+          loading="lazy"
+        />
+
+        <img
+          v-if="logoDark"
+          :src="logoDark"
+          :alt="`${name} logo`"
+          class="image-logo dark"
+          loading="lazy"
         />
       </a>
     </div>
@@ -35,6 +42,13 @@ const { go } = useRouter()
 </template>
 
 <style scoped>
+
+.image-logo {
+  object-fit: contain;
+  width: 36px;
+  height: 36px;
+}
+
 .packages-list {
   display: flex;
   flex-wrap: wrap;
@@ -57,4 +71,11 @@ const { go } = useRouter()
 .package-logo:hover {
   opacity: .6;
 }
+
+html.dark .image-logo.light {
+  display: none;
+}
+html:not(.dark) .image-logo.dark {
+  display: none;
+}
 </style>

docs/.vitepress/theme/components/icons/CarbonAdOverlay.vue

@@ -5,22 +5,32 @@ import IconButton from '../base/IconButton.vue';
 import VPDocAsideCarbonAds from 'vitepress/dist/client/theme-default/components/VPDocAsideCarbonAds.vue'
 import { x } from '../../../data/iconNodes'
 import createLucideIcon from 'lucide-vue-next/src/createLucideIcon';
+import { onMounted, ref } from 'vue';
 
 const { theme } = useData()
-const showAd = useSessionStorage('show-carbon-ads',true)
+const showAd = useSessionStorage('show-carbon-ads', true)
+const carbonLoaded = ref(true)
 
 defineProps<{
   drawerOpen: boolean
 }>()
 
 const CloseIcon = createLucideIcon('Close', x)
+
+onMounted(() => {
+  setTimeout(() => {
+    if (window?._carbonads == null) {
+      carbonLoaded.value = false
+    }
+  }, 5000)
+})
 </script>
 
 <template>
   <div
     :class="{
       'drawer-open': drawerOpen,
-      'hide-ad': !showAd
+      'hide-ad': !(showAd && carbonLoaded)
     }"
     class="floating-ad"
     v-if="theme.carbonAds"

docs/.vitepress/theme/components/icons/CopyCodeButton.vue

@@ -1,98 +1,98 @@
 <script setup lang="ts">
 import { computed } from 'vue';
-import { startCase, camelCase } from 'lodash-es'
+import { toPascalCase } from '@lucide/shared';
-import ButtonMenu from '../base/ButtonMenu.vue'
+import ButtonMenu from '../base/ButtonMenu.vue';
 import { useIconStyleContext } from '../../composables/useIconStyle';
 import useConfetti from '../../composables/useConfetti';
 
 const props = defineProps<{
-  name: string
+  name: string;
-  popoverPosition?: 'top' | 'bottom'
+  popoverPosition?: 'top' | 'bottom';
-}>()
+}>();
-const { size, color, strokeWidth, absoluteStrokeWidth } = useIconStyleContext()
+const { size, color, strokeWidth, absoluteStrokeWidth } = useIconStyleContext();
-const { animate, confetti } = useConfetti()
+const { animate, confetti } = useConfetti();
 const componentName = computed(() => {
-  return startCase(camelCase(props.name)).replace(/\s/g, '')
+  return (toPascalCase(props.name) as string).replace(/\s/g, '');
-})
+});
 
 function copyJSX() {
-  let attrs = ['']
+  let attrs = [''];
 
   if (size.value && size.value !== 24) {
-    attrs.push(`size={${size.value}}`)
+    attrs.push(`size={${size.value}}`);
   }
 
   if (color.value && color.value !== 'currentColor') {
-    attrs.push(`color="${color.value}"`)
+    attrs.push(`color="${color.value}"`);
   }
 
   if (strokeWidth.value && strokeWidth.value !== 2) {
-    attrs.push(`strokeWidth={${strokeWidth.value}}`)
+    attrs.push(`strokeWidth={${strokeWidth.value}}`);
   }
 
   if (absoluteStrokeWidth.value) {
-    attrs.push(`absoluteStrokeWidth`)
+    attrs.push(`absoluteStrokeWidth`);
   }
 
-  const code = `<${componentName.value}${attrs.join(' ')} />`
+  const code = `<${componentName.value}${attrs.join(' ')} />`;
 
-  navigator.clipboard.writeText(code)
+  navigator.clipboard.writeText(code);
 }
 
 function copyComponentName() {
-  const code = componentName.value
+  const code = componentName.value;
 
-  navigator.clipboard.writeText(code)
+  navigator.clipboard.writeText(code);
 }
 
 function copyVue() {
-  let attrs = ['']
+  let attrs = [''];
 
   if (size.value && size.value !== 24) {
-    attrs.push(`:size="${size.value}"`)
+    attrs.push(`:size="${size.value}"`);
   }
 
   if (color.value && color.value !== 'currentColor') {
-    attrs.push(`color="${color.value}"`)
+    attrs.push(`color="${color.value}"`);
   }
 
   if (strokeWidth.value && strokeWidth.value !== 2) {
-    attrs.push(`:stroke-width="${strokeWidth.value}"`)
+    attrs.push(`:stroke-width="${strokeWidth.value}"`);
   }
 
   if (absoluteStrokeWidth.value) {
-    attrs.push(`absoluteStrokeWidth`)
+    attrs.push(`absoluteStrokeWidth`);
   }
 
-  const code = `<${componentName.value}${attrs.join(' ')} />`
+  const code = `<${componentName.value}${attrs.join(' ')} />`;
 
-  navigator.clipboard.writeText(code)
+  navigator.clipboard.writeText(code);
 }
 
 function copyAngular() {
-  let attrs = ['']
+  let attrs = [''];
 
-  attrs.push(`name="${props.name}"`)
+  attrs.push(`name="${props.name}"`);
 
   if (size.value && size.value !== 24) {
-    attrs.push(`[size]="${size.value}"`)
+    attrs.push(`[size]="${size.value}"`);
   }
 
   if (color.value && color.value !== 'currentColor') {
-    attrs.push(`color="${color.value}"`)
+    attrs.push(`color="${color.value}"`);
   }
 
   if (strokeWidth.value && strokeWidth.value !== 2) {
-    attrs.push(`[strokeWidth]="${strokeWidth.value}"`)
+    attrs.push(`[strokeWidth]="${strokeWidth.value}"`);
   }
 
   if (absoluteStrokeWidth.value) {
-    attrs.push(`[absoluteStrokeWidth]="true"`)
+    attrs.push(`[absoluteStrokeWidth]="true"`);
   }
 
-  const code = `<lucide-icon${attrs.join(' ')}></lucide-icon>`
+  const code = `<lucide-icon${attrs.join(' ')}></lucide-icon>`;
 
-  navigator.clipboard.writeText(code)
+  navigator.clipboard.writeText(code);
 }
 </script>
 
@@ -106,11 +106,11 @@ function copyAngular() {
     data-confetti-text="Copied!"
     :popoverPosition="popoverPosition"
     :options="[
-      { text: 'Copy JSX' , onClick: copyJSX },
+      { text: 'Copy JSX', onClick: copyJSX },
-      { text: 'Copy Component Name' , onClick: copyComponentName },
+      { text: 'Copy Component Name', onClick: copyComponentName },
-      { text: 'Copy Vue' , onClick: copyVue },
+      { text: 'Copy Vue', onClick: copyVue },
-      { text: 'Copy Svelte' , onClick: copyJSX },
+      { text: 'Copy Svelte', onClick: copyJSX },
-      { text: 'Copy Angular' , onClick: copyAngular },
+      { text: 'Copy Angular', onClick: copyAngular },
     ]"
   />
 </template>

docs/.vitepress/theme/components/icons/IconInfo.vue

@@ -9,6 +9,8 @@ import {useData, useRouter} from 'vitepress';
 import { computed } from 'vue';
 import createLucideIcon from 'lucide-vue-next/src/createLucideIcon';
 import { diamond }  from '../../../data/iconNodes'
+import deprecationReasonTemplate from '../../../../../tools/build-icons/utils/deprecationReasonTemplate.ts';
+
 
 const props = defineProps<{
   icon: IconEntity
@@ -24,6 +26,15 @@ const tags = computed(() => {
 })
 
 const DiamondIcon = createLucideIcon('Diamond', diamond)
+
+const deprecatedTitle = computed(() => {
+  if (!props.icon.deprecationReason) return '';
+  return deprecationReasonTemplate(props.icon.deprecationReason, {
+    componentName: props.icon.name,
+    iconName: props.icon.name,
+    toBeRemovedInVersion: props.icon.toBeRemovedInVersion,
+  });
+});
 </script>
 
 <template>
@@ -36,6 +47,13 @@ const DiamondIcon = createLucideIcon('Diamond', diamond)
         <DiamondIcon fill="currentColor" :size="12"/>
         {{ icon.externalLibrary }}
       </div>
+      <Badge
+        v-if="icon.deprecated"
+        class="deprecated-badge"
+        :title="deprecatedTitle"
+      >
+        Deprecated
+      </Badge>
     </div>
     <div class="tags-scroller" v-if="tags.length">
       <p class="icon-tags horizontal-scroller">
@@ -98,6 +116,16 @@ const DiamondIcon = createLucideIcon('Diamond', diamond)
   align-items: center;
 }
 
+.deprecated-badge {
+  background-color: var(--vp-c-brand-5);
+  margin-left: 40px;
+  opacity: .8;
+}
+
+.deprecated-badge:hover {
+  background-color: var(--vp-c-brand-2);
+}
+
 .icon-tags {
   font-size: 16px;
   color: var(--vp-c-text-2);

docs/.vitepress/theme/components/icons/IconShowcase.vue

@@ -0,0 +1,438 @@
+<script setup lang="ts">
+import type { IconEntity } from '../../types';
+import { computed } from 'vue';
+import createLucideIcon from 'lucide-vue-next/src/createLucideIcon.ts';
+import Calendar from '../../../data/iconDetails/calendar.ts';
+import Clock from '../../../data/iconDetails/clock.ts';
+import Bug from '../../../data/iconDetails/bug.ts';
+import Rocket from '../../../data/iconDetails/rocket.ts';
+import TriangleAlert from '../../../data/iconDetails/triangle-alert.ts';
+import PartyPopper from '../../../data/iconDetails/party-popper.ts';
+import Scissors from '../../../data/iconDetails/scissors.ts';
+import Copy from '../../../data/iconDetails/copy.ts';
+import Save from '../../../data/iconDetails/save.ts';
+import Clipboard from '../../../data/iconDetails/clipboard.ts';
+import MessageCircle from '../../../data/iconDetails/message-circle.ts';
+import ThumbsDown from '../../../data/iconDetails/thumbs-down.ts';
+import ThumbsUp from '../../../data/iconDetails/thumbs-up.ts';
+import Heart from '../../../data/iconDetails/heart.ts';
+import Folder from '../../../data/iconDetails/folder.ts';
+import Files from '../../../data/iconDetails/files.ts';
+import Plus from '../../../data/iconDetails/plus.ts';
+import File from '../../../data/iconDetails/file.ts';
+import FileText from '../../../data/iconDetails/file-text.ts';
+
+const props = defineProps<{
+  name: IconEntity['name'];
+  iconNode: IconEntity['iconNode'];
+}>();
+
+const iconComponent = computed(() => {
+  if (!props.name || !props.iconNode) return null;
+  return createLucideIcon(props.name, props.iconNode);
+});
+
+const CalendarIcon = createLucideIcon('calendar', Calendar.iconNode);
+const ClockIcon = createLucideIcon('clock', Clock.iconNode);
+const BugIcon = createLucideIcon('bug', Bug.iconNode);
+const RocketIcon = createLucideIcon('rocket', Rocket.iconNode);
+const AlertTriangleIcon = createLucideIcon('alert-triangle', TriangleAlert.iconNode);
+const ScissorsIcon = createLucideIcon('scissors', Scissors.iconNode);
+const CopyIcon = createLucideIcon('copy', Copy.iconNode);
+const SaveIcon = createLucideIcon('save', Save.iconNode);
+const ClipboardIcon = createLucideIcon('clipboard', Clipboard.iconNode);
+const PartyPopperIcon = createLucideIcon('party-popper', PartyPopper.iconNode);
+const HeartIcon = createLucideIcon('heart', Heart.iconNode);
+const ThumbsUpIcon = createLucideIcon('thumbs-up', ThumbsUp.iconNode);
+const ThumbsDownIcon = createLucideIcon('thumbs-down', ThumbsDown.iconNode);
+const MessageCircleIcon = createLucideIcon('message-circle', MessageCircle.iconNode);
+const FolderIcon = createLucideIcon('folder.ts', Folder.iconNode);
+const FilesIcon = createLucideIcon('files.ts', Files.iconNode);
+const PlusIcon = createLucideIcon('plus.ts', Plus.iconNode);
+const FileIcon = createLucideIcon('file.ts', File.iconNode);
+const FileTextIcon = createLucideIcon('file-text.ts', FileText.iconNode);
+
+const prettyName = props.name
+  .split('-')
+  .at(0)
+  .split('')
+  .map((character, index) => (index === 0 ? character.toUpperCase() : character))
+  .join('');
+</script>
+
+<template>
+  <section class="showcase">
+    <h2 class="title">See this icon in action</h2>
+    <div class="showcase-grid">
+      <div class="showcase-item column">
+        <div class="placeholder"></div>
+        <div class="placeholder"></div>
+        <div class="placeholder"></div>
+        <div class="placeholder narrow"></div>
+        <div class="spacer"></div>
+        <div class="actions">
+          <button class="button button-brand">
+            <iconComponent />
+            {{ prettyName }}
+          </button>
+          <button class="button button-alt">Cancel</button>
+        </div>
+      </div>
+      <div class="showcase-item column">
+        <div class="placeholder narrow"></div>
+        <div class="input-wrapper">
+          <CalendarIcon v-if="name !== 'calendar'" />
+          <ClockIcon v-if="name == 'calendar'" />
+          <input
+            type="text"
+            v-if="name !== 'calendar'"
+            placeholder="Enter a date..."
+          />
+          <input
+            type="text"
+            v-if="name == 'calendar'"
+            placeholder="Enter a time..."
+          />
+        </div>
+        <div class="spacer"></div>
+        <div class="placeholder narrow"></div>
+        <div class="input-wrapper">
+          <iconComponent />
+          <input
+            type="text"
+            placeholder="Enter a value..."
+          />
+        </div>
+      </div>
+      <div class="showcase-item column">
+        <div
+          class="row"
+          v-if="name !== 'bug'"
+        >
+          <div class="placeholder"></div>
+          <div class="badge badge-red">
+            <BugIcon :size="20" />
+            Bug
+          </div>
+        </div>
+        <div
+          class="row"
+          v-else
+        >
+          <div class="placeholder"></div>
+          <div class="badge badge-red">
+            <AlertTriangleIcon :size="20" />
+            Alert
+          </div>
+        </div>
+        <div class="row">
+          <div class="placeholder"></div>
+          <div class="badge badge-indigo">
+            <RocketIcon
+              :size="20"
+              v-if="name !== 'rocket'"
+            />
+            <PartyPopperIcon
+              :size="20"
+              v-else
+            />
+            Feature
+          </div>
+        </div>
+        <div class="row">
+          <div class="placeholder"></div>
+          <div class="badge badge-green">
+            <iconComponent :size="20" />
+            {{ prettyName }}
+          </div>
+        </div>
+      </div>
+      <div class="showcase-item column">
+        <button class="button button-alt button-square">
+          <FolderIcon v-if="name !== 'folder'" />
+          <FilesIcon v-else />
+          Documents
+          <PlusIcon class="ms-auto" />
+        </button>
+        <button class="button button-alt button-square">
+          <FileIcon v-if="name !== 'file'" />
+          <FileTextIcon v-else />
+          Readme
+        </button>
+        <button class="button button-alt button-square">
+          <iconComponent />
+          {{ prettyName }}
+          <span class="badge-notification ms-auto">12</span>
+        </button>
+      </div>
+      <div class="showcase-item column">
+        <div class="placeholder"></div>
+        <div class="placeholder"></div>
+        <div class="placeholder"></div>
+        <div class="placeholder narrow"></div>
+        <div class="spacer"></div>
+        <div class="actions">
+          <div class="icon-counter">
+            <HeartIcon v-if="name !== 'heart'" />
+            <ThumbsUpIcon v-else />
+            112
+          </div>
+          <div class="spacer"></div>
+          <div class="icon-counter">
+            <MessageCircleIcon v-if="name !== 'message-circle'" />
+            <ThumbsDownIcon v-else />
+            8
+          </div>
+          <div class="spacer"></div>
+          <div class="icon-counter">
+            <iconComponent />
+            11
+          </div>
+        </div>
+      </div>
+      <div class="showcase-item">
+        <div class="column align-items-center">
+          <div class="actions justify-content-center">
+            <button class="button button-icon">
+              <CopyIcon v-if="name !== 'copy'" />
+              <SaveIcon v-else />
+            </button>
+            <button class="button button-icon">
+              <ScissorsIcon v-if="name !== 'scissors'" />
+              <SaveIcon v-else />
+            </button>
+            <button class="button button-icon">
+              <ClipboardIcon v-if="name !== 'clipboard'" />
+              <SaveIcon v-else />
+            </button>
+            <button class="button button-icon">
+              <iconComponent></iconComponent>
+              <span class="badge-notification">2</span>
+            </button>
+          </div>
+          <div class="spacer"></div>
+          <div class="placeholder"></div>
+          <div class="placeholder"></div>
+          <div class="placeholder"></div>
+        </div>
+      </div>
+    </div>
+  </section>
+</template>
+
+<style scoped>
+.showcase {
+  margin-bottom: 32px;
+}
+
+.showcase-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(320px, 1fr));
+  gap: 48px;
+  margin-inline-start: 24px;
+  margin-block-start: 48px;
+}
+
+.showcase-item {
+  padding: 24px;
+  border-radius: 8px;
+  background-color: var(--vp-c-bg);
+  box-shadow:
+    var(--vp-shadow-4),
+    -24px -24px 0 var(--vp-c-bg-soft);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  min-height: 240px;
+}
+
+.spacer {
+  flex-basis: 0;
+}
+
+.button {
+  position: relative;
+  border-radius: 32px;
+  padding: 8px 16px;
+  display: flex;
+  flex-direction: row;
+  gap: 12px;
+  font-weight: 500;
+  transition:
+    color 0.25s,
+    border-color 0.25s,
+    background-color 0.25s;
+
+  border-color: var(--vp-button-alt-border);
+  color: var(--vp-button-alt-text);
+  background-color: var(--vp-button-alt-bg);
+  &:hover {
+    border-color: var(--vp-button-alt-hover-border);
+    color: var(--vp-button-alt-hover-text);
+    background-color: var(--vp-button-alt-hover-bg);
+  }
+  &.button-brand {
+    border-color: var(--vp-button-brand-border);
+    color: var(--vp-button-brand-text);
+    background-color: var(--vp-button-brand-bg);
+    &:hover {
+      border-color: var(--vp-button-brand-hover-border);
+      color: var(--vp-button-brand-hover-text);
+      background-color: var(--vp-button-brand-hover-bg);
+    }
+  }
+  &.button-icon {
+    padding: 12px;
+  }
+  &.button-square {
+    border-radius: 8px;
+    width: 100%;
+  }
+}
+
+.actions {
+  display: flex;
+  flex-direction: row;
+  flex-wrap: wrap;
+  gap: 12px;
+}
+
+.lucide {
+  flex-shrink: 0;
+  flex-grow: 0;
+}
+
+.placeholder {
+  display: block;
+  background-color: var(--vp-c-bg-soft);
+  border-radius: 32px;
+  height: 16px;
+  width: 100%;
+
+  &.narrow {
+    width: 33%;
+  }
+}
+
+.input-wrapper {
+  position: relative;
+  width: 100%;
+  .lucide {
+    position: absolute;
+    inset-inline-start: 12px;
+    inset-block: 50%;
+    translate: 0 -50%;
+    color: var(--vp-c-text-1);
+    opacity: 0.7;
+  }
+  input {
+    padding: 12px 20px;
+    padding-inline-start: 48px;
+    border-radius: 8px;
+    background-color: var(--vp-c-bg-soft);
+    color: var(--vp-c-text-1);
+    display: block;
+    width: 100%;
+    border: 2px solid transparent;
+    transition:
+      color 0.25s,
+      border-color 0.25s,
+      background-color 0.25s;
+    &:hover {
+      border-color: var(--vp-c-border);
+    }
+    &:focus {
+      border-color: var(--vp-c-brand);
+    }
+  }
+  &:focus-within {
+    .lucide {
+      opacity: 1;
+    }
+  }
+}
+
+.badge {
+  flex-shrink: 0;
+  display: flex;
+  flex-direction: row;
+  align-items: center;
+  gap: 6px;
+  padding: 4px 8px;
+  border-radius: 8px;
+  background-color: transparent;
+  overflow: hidden;
+  position: relative;
+  color: var(--badge-color);
+  &:before {
+    content: ' ';
+    inset: 0;
+    position: absolute;
+    background-color: var(--badge-color);
+    opacity: 0.1;
+  }
+  &.badge-indigo {
+    --badge-color: var(--vp-c-indigo-2);
+  }
+  &.badge-green {
+    --badge-color: var(--vp-c-green-2);
+  }
+  &.badge-red {
+    --badge-color: var(--vp-c-brand);
+  }
+}
+
+.badge-notification {
+  background-color: var(--vp-c-brand);
+  color: var(--vp-button-brand-text);
+  border-radius: 32px;
+  padding: 0 8px;
+  min-width: 24px;
+  min-height: 24px;
+}
+
+.button-icon {
+  .badge-notification {
+    position: absolute;
+    top: 0;
+    right: 0;
+    translate: 33% -33%;
+  }
+}
+
+.row {
+  display: flex;
+  flex-direction: row;
+  gap: 12px;
+  align-items: center;
+  width: 100%;
+}
+
+.icon-counter {
+  display: flex;
+  flex-direction: row;
+  gap: 6px;
+  color: var(--vp-c-text-2);
+  align-items: center;
+}
+
+.column {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  align-items: start;
+  width: 100%;
+}
+
+.align-items-center {
+  align-items: center;
+}
+
+.justify-content-center {
+  justify-content: center;
+}
+
+.ms-auto {
+  margin-inline-start: auto;
+}
+</style>

docs/.vitepress/theme/components/icons/IconsOverview.vue

@@ -15,6 +15,15 @@ import CarbonAdOverlay from './CarbonAdOverlay.vue';
 const ICON_SIZE = 56;
 const ICON_GRID_GAP = 8;
 
+const initialGridItems = computed(() => {
+  if (containerWidth.value === 0) return 120;
+  
+  const itemsPerRow = columnSize.value || 10;
+  const visibleRows = Math.ceil(window.innerHeight / (ICON_SIZE + ICON_GRID_GAP));
+
+  return Math.min(itemsPerRow * (visibleRows + 2), 200); 
+});
+
 const props = defineProps<{
   icons: IconEntity[];
 }>();
@@ -114,11 +123,22 @@ function handleCloseDrawer() {
       />
     </StickyBar>
     <NoResults
-      v-if="list.length === 0"
+      v-if="searchResults.length === 0 && searchQuery !== ''"
       :searchQuery="searchQuery"
       @clear="searchQuery = ''"
     />
-    <div v-bind="wrapperProps" class="icon">
+    <IconGrid
+      v-else-if="list.length === 0"
+      overlayMode
+      :icons="searchResults.slice(0, initialGridItems)"
+      :activeIcon="activeIconName"
+      @setActiveIcon="setActiveIconName"
+    />
+    <div
+      v-bind="wrapperProps"
+      class="icon"
+      v-else
+    >
       <IconGrid
         v-for="{ index, data: icons } in list"
         :key="index"

docs/.vitepress/theme/components/icons/RelatedIcons.vue

@@ -1,29 +1,20 @@
 <script setup lang="ts">
-import type { IconEntity } from '../../types'
+import type { IconEntity } from '../../types';
-import IconGrid from './IconGrid.vue'
+import IconGrid from './IconGrid.vue';
+
 defineProps<{
-  icons: IconEntity[]
+  icons: IconEntity[];
-}>()
+}>();
 </script>
 
 <template>
   <section class="related-icons">
-    <h2 class="title">
+    <h2 class="title">More icons like this</h2>
-      Related Icons
+    <IconGrid :icons="icons" />
-    </h2>
-    <IconGrid
-      :icons="icons"
-    />
   </section>
 </template>
 
 <style scoped>
-.title {
-  margin-bottom: 24px;
-  font-size: 19px;
-  font-weight: 500;
-}
-
 .related-icons {
   margin-bottom: 32px;
 }

docs/.vitepress/theme/components/icons/SidebarIconCustomizer.vue

@@ -47,6 +47,7 @@ function resetStyle () {
   color.value = STYLE_DEFAULTS.color
   strokeWidth.value = STYLE_DEFAULTS.strokeWidth
   size.value = STYLE_DEFAULTS.size
+  absoluteStrokeWidth.value = STYLE_DEFAULTS.absoluteStrokeWidth
 }
 
 watch(absoluteStrokeWidth, (enabled) => {
@@ -59,9 +60,8 @@ const customizingActive = computed(() => {
   return color.value !== STYLE_DEFAULTS.color
     || strokeWidth.value !== STYLE_DEFAULTS.strokeWidth
     || size.value !== STYLE_DEFAULTS.size
+    || absoluteStrokeWidth.value !== STYLE_DEFAULTS.absoluteStrokeWidth
 })
-
-
 </script>
 
 <template>
@@ -120,8 +120,8 @@ const customizingActive = computed(() => {
       label="Absolute Stroke width"
     >
       <Switch
-        id="size"
+        id="absolute-stroke-width"
-        name="size"
+        name="absolute-stroke-width"
         v-model="absoluteStrokeWidth"
       />
     </InputField>
@@ -161,9 +161,4 @@ const customizingActive = computed(() => {
 .color-picker {
   margin-left: auto;
 }
-
-#absolute-stroke-width {
-  flex-direction: row-reverse;
-}
-
 </style>

docs/.vitepress/theme/components/packages/PackageList.data.ts

@@ -1,21 +1,27 @@
-import packageData from '../../../data/packageData.json';
+import packageDataList from '../../../data/packageData.json';
 import thirdPartyPackages from '../../../data/packageData.thirdParty.json';
 import fetchPackages from '../../../lib/fetchPackages';
 
 export default {
   async load() {
-    const packages = await fetchPackages();
+    const packageJsonList = await fetchPackages();
 
     return {
-      packages: packages
+      packages: packageJsonList
-        .filter((p) => p?.name != null && p.name in packageData)
+        .filter((pJson) => pJson?.name != null && pJson.name in packageDataList)
-        .map((pData) => ({
+        .map((pJson) => {
-          ...pData,
+          const packageData = packageDataList[pJson.name];
-          ...packageData[pData.name],
+          return {
-          documentation: `/guide/packages/${pData.name}`,
+            ...pJson,
-          source: `https://github.com/lucide-icons/lucide/tree/main/packages/${pData.name}`,
+            ...packageData,
-          icon: `/framework-logos/${packageData[pData.name].icon}.svg`,
+            documentation: `/guide/packages/${packageData.docsAlias ?? pJson.name}`,
-        }))
+            source: `https://github.com/lucide-icons/lucide/tree/main/packages/${packageData.packageDirname ?? pJson.name}`,
+            icon: `/framework-logos/${packageData.icon}.svg`,
+            iconDark: Boolean(packageData.iconDark)
+              ? `/framework-logos/${packageData.iconDark}.svg`
+              : null,
+          };
+        })
         .sort((a, b) => a.order - b.order),
       thirdPartyPackages,
     };

docs/.vitepress/theme/style.css

@@ -25,6 +25,7 @@
   --vp-code-editor-string: #032f62;
 
   --vp-c-text-4: rgba(60, 60, 67, 0.32);
+  --vp-home-hero-name-color: var(--vp-c-text);
 }
 
 .dark {
@@ -60,36 +61,15 @@
 .VPHomeHero .image-container {
   transform: none;
   width: 100%;
-  /* padding: 0 24px; */
 }
 
-/* .VPHomeHero .container {
+.VPHomeHero .name::first-line {
-  flex-direction: column-reverse;
-} */
-.VPHomeHero .container .main {
-  /* flex:1; */
-  flex-shirk: 0;
-}
-
-.VPHomeHero .container .main h1.name {
-  color: var(--vp-c-text);
-}
-.VPHomeHero .container .main h1.name .clip {
-  color: inherit;
-  -webkit-text-fill-color: unset;
-  color: var(--vp-c-text);
-  font-size: 36px;
-}
-
-.VPHomeHero .container .main h1::first-line {
   color: var(--vp-c-brand);
 }
 
-/*  */
 .VPHomeHero .container .image {
   margin: 0;
   order: 2;
-  /* flex: 1; */
   margin-top: 32px;
 }
 
@@ -98,10 +78,6 @@
   justify-content: flex-end;
 }
 
-.VPHomeHero .container .image-bg {
-  display: none;
-}
-
 .VPFeature .icon {
   background-color: var(--vp-c-bg);
 }
@@ -115,12 +91,6 @@
   padding-left: 0;
 }
 
-@media (min-width: 640px) {
-  .VPHomeHero .container .main h1.name .clip {
-    font-size: unset;
-  }
-}
-
 @media (min-width: 960px) {
   .VPHomeHero .container .image {
     order: 1;
@@ -140,18 +110,11 @@
   .VPHomeHero .container .image-container {
     display: block;
   }
-
-  .VPHomeHero .container .main h1.name {
-  }
 }
 
 .VPNavBarHamburger .container > span {
   border-radius: 2px;
 }
-/*
-html:has(* .outline-link:target) {
-  scroll-behavior: smooth;
-} */
 
 .sp-wrapper + * {
   margin-top: 24px;
@@ -183,7 +146,6 @@ html:has(* .outline-link:target) {
   font-size: 14px;
   font-weight: 500;
   position: relative;
-  /* box-sizing: content-box; */
 }
 
 .sp-wrapper .sp-tabs .sp-tab-button:after {

docs/.vitepress/theme/types.ts

@@ -6,6 +6,9 @@ export interface IconMetaData {
   categories: string[];
   contributors: string[];
   aliases?: string[];
+  deprecated?: boolean;
+  deprecationReason?: string;
+  toBeRemovedInVersion?: string;
 }
 
 export type ExternalLibs = 'lab';
@@ -33,12 +36,19 @@ interface Shield {
 
 export interface PackageItem {
   name: string;
+  // set when the package's directory
+  // name under the `packages/` directory
+  // is diffrent from the package name
+  packageDirname?: string;
   description: string;
   icon: string;
   iconDark: string;
   shields: Shield[];
   source: string;
   documentation: string;
+  // set when the docs page name is
+  // diffrent from the package name
+  docsAlias?: string;
   order?: number;
   private?: boolean;
   flutter?: object;

docs/guide/advanced/accessibility.md

@@ -139,22 +139,22 @@ contained icon.
 ```tsx
 // Don't do this
 <button class="btn-icon">
-  <Home/>
+  <House/>
 </button>
 
 // Don't do this either
 <button class="btn-icon">
-  <Home aria-label="Home icon"/>
+  <House aria-label="Home icon"/>
 </button>
 
 // This works but might not be the best solution, see below
 <button aria-label="Go to home" class="btn-icon">
-  <Home/>
+  <House/>
 </button>
 
 // Do this instead
 <button class="btn-icon">
-  <Home/>
+  <House/>
   <span class="visually-hidden">Go to home</span>
 </button>
 ```
@@ -167,6 +167,7 @@ Although you could provide accessible labels to your elements via the `aria-labe
 generally recommend avoiding this and instead suggest that you use your chosen CSS framework's "
 visually hidden" utility whenever possible. You can
 [read more about why `aria-label` might not be the best solution](https://gomakethings.com/revisting-aria-label-versus-a-visually-hidden-class/).
+
 ### Example - Radix UI
 
 Use [Radix UI's built-in accessible icon utility component](https://www.radix-ui.com/primitives/docs/utilities/accessible-icon).
@@ -179,6 +180,7 @@ import { AccessibleIcon } from '@radix-ui/react-accessible-icon';
   <ArrowRightIcon />
 </AccessibleIcon>
 ```
+
 ### Example - Bootstrap
 
 ```html

docs/guide/advanced/aliased-names.md

@@ -0,0 +1,93 @@
+# Aliased Names
+
+Icons can have multiple names for the same icon. This is because we choose to rename some icons to make them more consistent with the rest of the icon set, or the name was not generic. For example, the `edit-2` icon is renamed to `pen` to make the name more generic, since it is just a pen icon.
+
+Beside aliases names lucide also includes prefixed and suffixed names to use within your project. This is to prevent import name collisions with other libraries or your own code.
+
+```tsx
+// These are all the same icon
+import {
+  House,
+  HouseIcon,
+  LucideHouse,
+} from "lucide-react";
+```
+
+## Choosing import name style
+
+To be consistent in your imports or want to change the autocompletion of Lucide icons in your IDE there an option to able the choose the import name style you want.
+
+This can be done by creating a custom module declaration file to override the lucide imports and turning off the autocomplete in your IDE.
+
+### Turn off autocomplete in your IDE
+
+```json [.vscode/settings.json]
+{
+  "typescript.preferences.autoImportFileExcludePatterns": [
+    "lucide-react", // or
+    "lucide-preact", // or
+    "lucide-react-native", // or
+    "lucide-vue-next",
+  ]
+}
+```
+
+### Create a custom module declaration file
+
+Only available for `lucide-react`, `lucide-preact`, `lucide-react-native`, `lucide-vue-next` package.
+This will enable you to choose the import name style you want to use in your project.
+
+::: code-group
+
+```ts [React]
+declare module "lucide-react" {
+  // Prefixed import names
+  export * from "lucide-react/dist/lucide-react.prefixed";
+  // or
+  // Suffixed import names
+  export * from "lucide-react/dist/lucide-react.suffixed";
+}
+```
+
+```ts [Vue]
+declare module "lucide-vue-next" {
+  // Prefixed import names
+  export * from "lucide-vue-next/dist/lucide-vue-next.prefixed";
+  // or
+  // Suffixed import names
+  export * from "lucide-vue-next/dist/lucide-vue-next.suffixed";
+}
+```
+
+```ts [Preact]
+declare module "lucide-preact" {
+  // Prefixed import names
+  export * from "lucide-preact/dist/lucide-preact.prefixed";
+  // or
+  // Suffixed import names
+  export * from "lucide-preact/dist/lucide-preact.suffixed";
+}
+```
+
+```ts [React Native]
+declare module "lucide-react-native" {
+  // Prefixed import names
+  export * from "lucide-react-native/dist/lucide-react-native.prefixed";
+  // or
+  // Suffixed import names
+  export * from "lucide-react-native/dist/lucide-react-native.suffixed";
+}
+```
+
+:::
+
+Place this in your project root or in a folder where your tsconfig.json is located, or locate it in your defined type directory.
+Easiest way is to create a `@types` folder in your project root and name the file `[package-name].d.ts`.
+
+### Import name styles
+
+| Import Style  | Available imports           | Declaration file import |
+| ------------- | --------------------------- | ----------------------- |
+| Default       | Home, HomeIcon, LucideHome  |                         |
+| Prefixed      | LucideHome                  | [package].prefixed      |
+| Suffixed      | HomeIcon                    | [package].suffixed      |

docs/guide/design/icon-design-guide.md

@@ -42,7 +42,11 @@ Here are rules that should be followed to keep quality and consistency when maki
 
 ### 8. Distinct elements must have **2 pixels of spacing between each other**
 
-![2px-element-spacing](../../images/2px-element-spacing.svg?raw=true "2px-element-spacing")
+![2px-element-spacing](../../images/2px-element-spacing.svg?raw=true '2px-element-spacing')
+
+![2px-element-spacing-connected](../../images/2px-element-spacing-connected.svg?raw=true '2px-element-spacing-connected')
+
+![2px-element-spacing-abrupt-cut](../../images/2px-element-spacing-abrupt-cut.svg?raw=true '2px-element-spacing-abrupt-cut')
 
 ### 9. Icons should have a similar optical volume to `circle` and `square`.
 
@@ -52,7 +56,7 @@ Here are rules that should be followed to keep quality and consistency when maki
 
 ![optical-volume-high](../../images/optical-volume-high.svg?raw=true "optical-volume-high")
 
-**Tip:** place your icon next to circle or square and blur them both; your icon should not feel much darker than the base shape.
+**Tip:** place your icon next to the circle or square icon and blur them both; your icon should not feel much darker than the base shape.
 
 ### 10. Icons should be visually centered by their center of gravity.
 
@@ -76,7 +80,7 @@ Here are rules that should be followed to keep quality and consistency when maki
 
 ![curvature-uneven](../../images/curvature-uneven.svg?raw=true "curvature-uneven")
 
-**Tip:** make sure to use arcs or quadratic curves, when using cubic curves control points should have mirrored angles for smooth curves.
+**Tip:** make sure to use arcs or quadratic curves. When using cubic curves control points should have mirrored angles for smooth curves.
 
 ### 13. Icons should aim to be pixel perfect so that they will be sharp on low DPI displays.
 
@@ -142,7 +146,7 @@ For each icon these attributes are applied, corresponding to the above rules.
 ### Minify paths
 
 The code of paths can sometimes get quite large. To reduce file size we like to minify the code.
-We recommend to use the [SVGOMG](https://jakearchibald.github.io/svgomg/) to minify paths to 2 points of precision.
+We recommend to use [Lucide Studio](https://studio.lucide.dev/) to tidy paths to 3 points of precision.
 
 ### Allowed elements
 

docs/guide/index.md

@@ -12,7 +12,8 @@ Lucide is an open-source icon library that provides 1000+ vector (svg) files for
 ## Available Icons
 
 Lucide contains icons with different variants and states, allowing users to choose the most suitable icon for their needs. And if a desired icon isn't available yet, users can open a design request, and the Lucide community contributors will help provide new icons. With more icons to choose from, users have more options to work with in their projects.
-Complete Set of Icons
+
+### Complete Set of Icons
 
 As new applications with specific features arise, Lucide aims to provide a complete set of icons for every project. The community follows a set of design rules when designing new icons. These rules maintain standards for the icons, such as recognizability, consistency in style, and readability at all sizes. While creativity is valued in new icons, recognizable design conventions are important to ensure that the icons are easily identifiable by users.
 
@@ -28,7 +29,8 @@ However, not everyone can understand them easily. Read more about [how to use Lu
 
 ## Official Packages
 
-Lucide's official packages are designed to work on different platforms, making it easier for users to integrate icons into their projects. The packages are available for various technologies, including [Web (Vanilla)](https://lucide.dev/guide/packages/lucide), [React](https://lucide.dev/guide/packages/lucide-react), [React Native](https://lucide.dev/guide/packages/lucide-react-native), [Vue](https://lucide.dev/guide/packages/lucide-vue), [Vue 3](https://lucide.dev/guide/packages/lucide-vue-next), [Svelte](https://lucide.dev/guide/packages/lucide-svelte),[Preact](https://lucide.dev/guide/packages/lucide-preact), [Solid](https://lucide.dev/guide/packages/lucide-solid), [Angular](https://lucide.dev/guide/packages/lucide-angular), [NodeJS](https://lucide.dev/guide/packages/lucide-static#nodejs) and [Flutter](https://lucide.dev/guide/packages/lucide-flutter).
+Lucide's official packages are designed to work on different platforms, making it easier for users to integrate icons into their projects. The packages are available for various technologies, including [Web (Vanilla)](https://lucide.dev/guide/packages/lucide), [React](https://lucide.dev/guide/packages/lucide-react), [React Native](https://lucide.dev/guide/packages/lucide-react-native), [Vue](https://lucide.dev/guide/packages/lucide-vue), [Vue 3](https://lucide.dev/guide/packages/lucide-vue-next), [Svelte](https://lucide.dev/guide/packages/lucide-svelte), [Preact](https://lucide.dev/guide/packages/lucide-preact), [Solid](https://lucide.dev/guide/packages/lucide-solid), [Angular](https://lucide.dev/guide/packages/lucide-angular), [Astro](https://lucide.dev/guide/packages/lucide-astro), and [NodeJS](https://lucide.dev/guide/packages/lucide-static#nodejs).
 
 ## Community
+
 If you have any questions about Lucide, feel free to reach out to the community. You can find them on [GitHub](https://github.com/lucide-icons/lucide) and [Discord](https://discord.gg/EH6nSts).

docs/guide/installation.md

@@ -22,6 +22,10 @@ yarn add lucide
 npm install lucide
 ```
 
+```sh [bun]
+bun add lucide
+```
+
 :::
 
 For more details, see the [documentation](packages/lucide.md).
@@ -44,6 +48,10 @@ yarn add lucide-react
 npm install lucide-react
 ```
 
+```sh [bun]
+bun add lucide-react
+```
+
 :::
 
 For more details, see the [documentation](packages/lucide-react.md).
@@ -67,6 +75,10 @@ yarn add lucide-vue-next
 npm install lucide-vue-next
 ```
 
+```sh [bun]
+bun add lucide-vue-next
+```
+
 :::
 
 For more details, see the [documentation](packages/lucide-vue-next.md).
@@ -90,6 +102,10 @@ yarn add lucide-svelte
 npm install lucide-svelte
 ```
 
+```sh [bun]
+bun add lucide-svelte
+```
+
 :::
 
 For more details, see the [documentation](packages/lucide-svelte.md).
@@ -112,6 +128,10 @@ yarn add lucide-solid
 npm install lucide-solid
 ```
 
+```sh [bun]
+bun add lucide-solid
+```
+
 :::
 
 For more details, see the [documentation](packages/lucide-solid.md).
@@ -134,6 +154,10 @@ yarn add lucide-angular
 npm install lucide-angular
 ```
 
+```sh [bun]
+bun add lucide-angular
+```
+
 :::
 
 For more details, see the [documentation](packages/lucide-angular.md).
@@ -156,8 +180,41 @@ yarn add lucide-preact
 npm install lucide-preact
 ```
 
+```sh [bun]
+bun add lucide-preact
+```
+
+
 :::
 
+For more details, see the [documentation](packages/lucide-preact.md).
+
+## Astro
+
+Implementation of the lucide icon library for Astro applications.
+
+::: code-group
+
+```sh [pnpm]
+pnpm install @lucide/astro
+```
+
+```sh [yarn]
+yarn add @lucide/astro
+```
+
+```sh [npm]
+npm install @lucide/astro
+```
+
+```sh [bun]
+bun add @lucide/astro
+```
+
+:::
+
+For more details, see the [documentation](packages/lucide-astro.md).
+
 ## Static usage
 
 Implementation of the lucide icon library for multiple usages that like to use: SVG files icons, SVG Sprite, Icon Fonts and static SVG strings export in Common JS modules (for NodeJS).
@@ -176,6 +233,10 @@ yarn add lucide-static
 npm install lucide-static
 ```
 
+```sh [bun]
+bun add lucide-static
+```
+
 :::
 
 For more details, see the [documentation](packages/lucide-static.md).

docs/guide/packages/lucide-angular.md

@@ -18,6 +18,10 @@ yarn add lucide-angular
 npm install lucide-angular
 ```
 
+```sh [bun]
+bun add lucide-angular
+```
+
 :::
 
 ## How to use
@@ -27,11 +31,11 @@ npm install lucide-angular
 In any Angular module you wish to use Lucide icons in, you have to import `LucideAngularModule`, and pick any icons you wish to use:
 
 ```js
-import { LucideAngularModule, File, Home, Menu, UserCheck } from 'lucide-angular';
+import { LucideAngularModule, File, House, Menu, UserCheck } from 'lucide-angular';
 
 @NgModule({
   imports: [
-    LucideAngularModule.pick({File, Home, Menu, UserCheck})
+    LucideAngularModule.pick({File, House, Menu, UserCheck})
   ]
 })
 export class AppModule { }
@@ -40,14 +44,17 @@ export class AppModule { }
 or using standalone version:
 
 ```js
+import { Component } from '@angular/core';
 import { LucideAngularModule, FileIcon } from 'lucide-angular';
 
-@NgModule({
+@Component({
-  imports: [
+  standalone: true,
-    LucideAngularModule
+  selector: 'app-root',
-  ]
+  templateUrl: './app.component.html',
+  styleUrl: './app.component.scss',
+  imports: [LucideAngularModule]
 })
-export class AppModule {
+export class AppComponent {
   readonly FileIcon = FileIcon;
 }
 ```
@@ -57,7 +64,7 @@ Within your templates you may now use one of the following component tags to ins
 
 ```html
 <lucide-angular name="file" class="my-icon"></lucide-angular>
-<lucide-icon name="home" class="my-icon"></lucide-icon>
+<lucide-icon name="house" class="my-icon"></lucide-icon>
 <i-lucide name="menu" class="my-icon"></i-lucide>
 <span-lucide name="user-check" class="my-icon"></span-lucide>
 ```
@@ -81,7 +88,7 @@ You can pass additional props to adjust the icon appearance.
 | `absoluteStrokeWidth` | *boolean* | false        |
 
 ```html
-<i-lucide name="home" [size]="48" color="red" [strokeWidth]="1"></i-lucide>
+<i-lucide name="house" [size]="48" color="red" [strokeWidth]="1"></i-lucide>
 ```
 
 ### Global configuration
@@ -144,11 +151,11 @@ They can be used in the same way as the official icons.
 
 ```js
 import { LucideAngularModule } from 'lucide-angular';
-import { burger } from '@lucide/lab';
+import { coconut } from '@lucide/lab';
 
 @NgModule({
   imports: [
-    LucideAngularModule.pick({ burger })
+    LucideAngularModule.pick({ coconut })
   ]
 })
 export class AppModule { }

docs/guide/packages/lucide-astro.md

@@ -0,0 +1,187 @@
+# Lucide Astro
+
+Implementation of the lucide icon library for Astro applications.
+
+## Installation
+
+::: code-group
+
+```sh [pnpm]
+pnpm add @lucide/astro
+```
+
+```sh [yarn]
+yarn add @lucide/astro
+```
+
+```sh [npm]
+npm install @lucide/astro
+```
+
+```sh [bun]
+bun add @lucide/astro
+```
+
+:::
+
+## How to use
+
+Lucide is built with ES Modules, so it's completely tree-shakable.
+
+Each icon can be imported as an Astro component, which renders an inline SVG element. This way, only the icons that are imported into your project are included in the final bundle. The rest of the icons are tree-shaken away.
+
+### Example
+
+Default usage:
+
+```astro
+---
+import { Skull } from '@lucide/astro';
+---
+
+<Skull />
+```
+
+Additional props can be passed to adjust the icon:
+
+```astro
+---
+import { Camera } from '@lucide/astro';
+---
+
+<Camera color="#ff3e98" />
+```
+
+For faster builds and load times, you can import icons directly from the `@lucide/astro/icons` directory:
+
+```astro
+---
+import CircleAlert from '@lucide/astro/icons/circle-alert';
+---
+
+<CircleAlert color="#ff3e98" />
+```
+
+## Props
+
+| name                  | type      | default      |
+| --------------------- | --------- | ------------ |
+| `size`                | _number_  | 24           |
+| `color`               | _string_  | currentColor |
+| `stroke-width`        | _number_  | 2            |
+| `absoluteStrokeWidth` | _boolean_ | false        |
+
+### Applying props
+
+To customize the appearance of an icon, you can pass custom properties as props directly to the component. The component accepts all SVG attributes as props, which allows flexible styling of the SVG elements. See the list of SVG Presentation Attributes on [MDN](https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/Presentation).
+
+```astro
+---
+import { Phone } from '@lucide/astro';
+---
+
+<Phone fill="#333" />
+```
+
+This results a filled phone icon.
+
+## Types
+
+The package includes type definitions for all icons. This is useful if you want to dynamically render icons.
+
+### Example
+
+```astro
+---
+import { House, Library, Cog, type Icon as IconType } from '@lucide/astro';
+
+type MenuItem = {
+  name: string;
+  href: string;
+  icon: typeof IconType;
+};
+
+const menuItems: MenuItem[] = [
+  {
+    name: 'Home',
+    href: '/',
+    icon: House,
+  },
+  {
+    name: 'Blog',
+    href: '/blog',
+    icon: Library,
+  },
+  {
+    name: 'Projects',
+    href: '/projects',
+    icon: Cog,
+  },
+];
+---
+
+{
+  menuItems.map((item) => (
+    <a href={item.href}>
+      <item.icon />
+      <span>{item.name}</span>
+    </a>
+  ))
+}
+```
+
+## With Lucide lab or custom icons
+
+[Lucide lab](https://github.com/lucide-icons/lucide-lab) is a collection of icons that are not part of the Lucide main library.
+
+They can be used by using the `Icon` component.
+All props of the regular Lucide icons can be passed to adjust the icon appearance.
+
+### Using the `Icon` component
+
+This creates a single icon based on the iconNode passed and renders a Lucide icon component.
+
+```astro
+---
+import { Icon } from '@lucide/astro';
+import { burger, sausage } from '@lucide/lab';
+---
+
+<Icon iconNode={burger} />
+<Icon iconNode={sausage} color="red"/>
+```
+
+## One generic icon component
+
+It is possible to create one generic icon component to load icons, but it is not recommended.
+
+::: danger
+The example below imports all ES Modules, so exercise caution when using it. Importing all icons will significantly increase the build size of the application. This may be passable if you're doing SSG and SSR in server environments. However if you're doing SSR in serverless environments, it could negatively affect your app's performance, as a bigger bundle size will translate to an increase in cold starts.
+:::
+
+### Icon Component Example
+
+```astro
+---
+import { icons, type IconProps } from '@lucide/astro';
+
+interface Props extends IconProps {
+  name: keyof typeof icons;
+}
+
+const { name, ...restProps } = Astro.props;
+const Icon = icons[name];
+---
+
+<Icon {...restProps} />
+```
+
+### Using the Icon Component
+
+```astro
+---
+import LucideIcon from './LucideIcon.astro';
+---
+
+<LucideIcon name="Menu" />
+```

docs/guide/packages/lucide-preact.md

@@ -22,6 +22,10 @@ yarn add lucide-preact
 npm install lucide-preact
 ```
 
+```sh [bun]
+bun add lucide-preact
+```
+
 :::
 
 ## How to use
@@ -80,10 +84,10 @@ This creates a single icon based on the iconNode passed and renders a Lucide ico
 
 ```jsx
 import { Icon } from 'lucide-preact';
-import { burger } from '@lucide/lab';
+import { coconut } from '@lucide/lab';
 
 const App = () => (
-  <Icon iconNode={burger} />
+  <Icon iconNode={coconut} />
 );
 ```
 
@@ -115,7 +119,7 @@ export default Icon;
 import Icon from './Icon';
 
 const App = () => {
-  return <Icon name="home" />;
+  return <Icon name="house" />;
 };
 
 export default App;

docs/guide/packages/lucide-react-native.md

@@ -20,6 +20,10 @@ yarn add lucide-react-native
 npm install lucide-react-native
 ```
 
+```sh [bun]
+bun add lucide-react-native
+```
+
 :::
 
 ## How to use
@@ -74,10 +78,10 @@ This creates a single icon based on the iconNode passed and renders a Lucide ico
 
 ```jsx
 import { Icon } from 'lucide-react-native';
-import { burger } from '@lucide/lab';
+import { coconut } from '@lucide/lab';
 
 const App = () => (
-  <Icon iconNode={burger} />
+  <Icon iconNode={coconut} />
 );
 ```
 
@@ -109,7 +113,7 @@ export default Icon;
 import Icon from './Icon';
 
 const App = () => {
-  return <Icon name="home" />;
+  return <Icon name="house" />;
 };
 
 export default App;

docs/guide/packages/lucide-react.md

@@ -18,6 +18,10 @@ yarn add lucide-react
 npm install lucide-react
 ```
 
+```sh [bun]
+bun add lucide-react
+```
+
 :::
 
 ## How to use
@@ -74,115 +78,27 @@ This creates a single icon based on the iconNode passed and renders a Lucide ico
 
 ```jsx
 import { Icon } from 'lucide-react';
-import { burger } from '@lucide/lab';
+import { coconut } from '@lucide/lab';
 
 const App = () => (
-  <Icon iconNode={burger} />
+  <Icon iconNode={coconut} />
 );
 ```
 
-## One generic icon component
+## Dynamic Icon Component
 
-It is possible to create one generic icon component to load icons, but it is not recommended.
+It is possible to create one generic icon component to load icons. But it is not recommended, since it is importing all icons during the build. This increases build time and the different modules it will create.
 
-::: danger
+`DynamicIcon` is useful for applications that want to show icons dynamically by icon name. For example, when using a content management system with where icon names are stored in a database.
-The example below imports all ES Modules, so exercise caution when using it. Importing all icons will significantly increase the build size of the application, negatively affecting its performance. This is especially important to keep in mind when using bundlers like `Webpack`, `Rollup`, or `Vite`.
 
-This is not the case for the latest NextJS, because it uses server side rendering. The icons will be streamed to the client when needed. For NextJS with Dynamic Imports, see [dynamic imports](#nextjs-example) section for more information.
+For static use cases, it is recommended to import the icons directly.
-:::
 
-### Icon Component Example
+The same props can be passed to adjust the icon appearance. The `name` prop is required to load the correct icon.
 
 ```jsx
-import { icons } from 'lucide-react';
+import { DynamicIcon } from 'lucide-react/dynamic';
 
-const Icon = ({ name, color, size }) => {
+const App = () => (
-  const LucideIcon = icons[name];
+  <DynamicIcon name="camera" color="red" size={48} />
-
+);
-  return <LucideIcon color={color} size={size} />;
-};
-
-export default Icon;
-```
-
-#### Using the Icon Component
-
-```jsx
-import Icon from './Icon';
-
-const App = () => {
-  return <Icon name="Home" />;
-};
-
-export default App;
-```
-
-#### With Dynamic Imports
-
-Lucide react exports a dynamic import map `dynamicIconImports`, which is useful for applications that want to show icons dynamically by icon name. For example, when using a content management system with where icon names are stored in a database.
-
-When using client side rendering, it will fetch the icon component when it's needed. This will reduce the initial bundle size.
-
-The keys of the dynamic import map are the lucide original icon names (kebab case).
-
-Example with React suspense:
-
-```tsx
-import React, { lazy, Suspense } from 'react';
-import { LucideProps } from 'lucide-react';
-import dynamicIconImports from 'lucide-react/dynamicIconImports';
-
-const fallback = <div style={{ background: '#ddd', width: 24, height: 24 }}/>
-
-interface IconProps extends Omit<LucideProps, 'ref'> {
-  name: keyof typeof dynamicIconImports;
-}
-
-const Icon = ({ name, ...props }: IconProps) => {
-  const LucideIcon = lazy(dynamicIconImports[name]);
-
-  return (
-    <Suspense fallback={fallback}>
-      <LucideIcon {...props} />
-    </Suspense>
-  );
-}
-
-export default Icon
-```
-
-##### NextJS Example
-
-In NextJS, [the dynamic function](https://nextjs.org/docs/pages/building-your-application/optimizing/lazy-loading#nextdynamic) can be used to dynamically load the icon component.
-
-To make dynamic imports work with NextJS, you need to add `lucide-react` to the [`transpilePackages`](https://nextjs.org/docs/app/api-reference/next-config-js/transpilePackages) option in your `next.config.js` like this:
-
-```js
-/** @type {import('next').NextConfig} */
-const nextConfig = {
-  transpilePackages: ['lucide-react'] // add this
-}
-
-module.exports = nextConfig
-
-```
-
-You can then start using it:
-
-```tsx
-import dynamic from 'next/dynamic'
-import { LucideProps } from 'lucide-react';
-import dynamicIconImports from 'lucide-react/dynamicIconImports';
-
-interface IconProps extends LucideProps {
-  name: keyof typeof dynamicIconImports;
-}
-
-const Icon = ({ name, ...props }: IconProps) => {
-  const LucideIcon = dynamic(dynamicIconImports[name])
-
-  return <LucideIcon {...props} />;
-};
-
-export default Icon;
 ```

docs/guide/packages/lucide-solid.md

@@ -18,6 +18,10 @@ yarn add lucide-solid
 npm install lucide-solid
 ```
 
+```sh [bun]
+bun add lucide-solid
+```
+
 :::
 
 ## How to use
@@ -87,7 +91,7 @@ This creates a single icon based on the iconNode passed and renders a Lucide ico
 
 ```jsx
 import { Icon } from 'lucide-solid';
-import { burger, sausage } from '@lucide/lab';
+import { sausage } from '@lucide/lab';
 
 const App = () => (
   <Icon iconNode={sausage} color="red"/>

docs/guide/packages/lucide-static.md

@@ -1,24 +1,38 @@
 # Lucide Static
 
-This package include the following lucide implementations:
+This package includes the following implementations of Lucide icons:
 
-- All SVG files
+- Individual SVG files
 - SVG sprite
-- Icon fonts
+- Icon font files
-- JavaScript library containing strings of SVGs.
+- A JavaScript library exporting SVG strings
 
-## Why lucide-static?
+## Who is this for?
 
-This package is suitable for specific use cases, for example if you want to use icon fonts, SVG sprites, normal SVGs or Common.js SVG strings in your javascript project.
+`lucide-static` is suitable for _very specific use cases_ where you want to use Lucide icons without relying on a JavaScript framework or component system. It's ideal for:
 
-::: warning
+- Projects that use icon fonts with plain CSS or utility-first frameworks
-While they can be useful for prototyping, it is not recommended to use the SVG sprites or icon fonts provided by this package in production web apps as all the available icons are included in the app, hence increasing loading time and data usage. We recommend to use a bundler and tree-shaking to make sure only the icons you use are bundled with your app. Tree-shaking is only available in these packages: [lucide](lucide), [lucide-react](lucide-react), [lucide-vue](lucide-vue), [lucide-vue-next](lucide-vue-next), [lucide-angular](lucide-angular), [lucide-preact](lucide-preact)
+- Embedding raw SVG files or sprites directly in HTML
+- Using SVGs as CSS background images
+- Importing SVG strings into Node.js (CommonJS) environments
+
+::: danger
+### Not recommended for production {#production-warning}
+
+SVG sprites and icon fonts include **all icons**, which can significantly increase your app's bundle size and load time.
+
+For production environments, we recommend using a bundler with tree-shaking support to include only the icons you actually use. Consider using:
+
+- [lucide](lucide)
+- [lucide-react](lucide-react)
+- [lucide-vue](lucide-vue)
+- [lucide-vue-next](lucide-vue-next)
+- [lucide-angular](lucide-angular)
+- [lucide-preact](lucide-preact)
 :::
 
 ## Installation
 
-## Package Managers
-
 ::: code-group
 
 ```sh [pnpm]
@@ -33,66 +47,83 @@ yarn add lucide-static
 npm install lucide-static
 ```
 
+```sh [bun]
+bun add lucide-static
+```
+
 :::
 
-### CDN
+## SVG Files
 
-```html
+You can use standalone SVG files or SVG sprites in several ways.
+
+Check out our [codesandbox example](https://codesandbox.io/s/using-the-svg-sprite-lz1kk).
+
+### SVG file as image
+
+#### In HTML:
+
+::: code-group
+
+```html [Webpack]
 <!-- SVG file for a single icon -->
-<img src="https://unpkg.com/lucide-static@latest/icons/home.svg" />
+<img src="~lucide-static/icons/house.svg" />
-
-<!-- Icon font -->
-<style>
-  @font-face {
-    font-family: 'LucideIcons';
-    src: url(https://unpkg.com/lucide-static@latest/font/Lucide.ttf) format('truetype');
-  }
-</style>
 ```
 
-## Usage
+```html [CDN]
-
-Check out the [codesandbox examples](https://codesandbox.io/s/using-the-svg-sprite-lz1kk).
-
-### SVG Files
-
-#### SVG file as image
-
-To use it in for example html:
-
-```html
 <!-- SVG file for a single icon -->
-<img src="~lucide-static/icons/home.svg" />
+<img src="https://unpkg.com/lucide-static@latest/icons/house.svg" />
 ```
 
-```css
+:::
-.home-icon {
+
-  background-image: url(~lucide-static/icons/home.svg);
+#### In CSS:
+
+::: code-group
+
+```css [Webpack]
+.house-icon {
+  background-image: url(~lucide-static/icons/house.svg);
 }
 ```
 
-Make sure you have the correct webpack loaders to make this work. [url-loader](https://v4.webpack.js.org/loaders/url-loader/)
+```css [CDN]
+.house-icon {
+  background-image: url(https://unpkg.com/lucide-static@latest/icons/house.svg);
+}
+```
 
-#### SVG file as string
+:::
 
-You can simply import each SVG by targeting `lucide-static/icons/{icon-name}.svg`.
+Make sure you have the correct Webpack loader configured, such as [`url-loader`](https://v4.webpack.js.org/loaders/url-loader/).
-To use SVGs in your project you can for example use a [SVG loader](https://v4.webpack.js.org/loaders/svg-inline-loader/).
+
+### SVG file as string
+
+To import an SVG as a string (e.g., for templating):
 
 ```js
 import arrowRightIcon from 'lucide-static/icons/arrow-right';
-
-// return string of an SVG
 ```
 
-### SVG Sprite
+You'll need an SVG loader like [`svg-inline-loader`](https://v4.webpack.js.org/loaders/svg-inline-loader/).
 
-You may need additional loader for this.
+### Using the SVG sprite
+
+:::danger
+[Not intended for production use.](#production-warning)
+:::
+
+You may also need an additional SVG loader to handle this.
+
+#### Basic sprite usage (not production-optimized):
 
 ```html
-<!-- Icon Sprite, not recommended for production! -->
+<img src="lucide-static/sprite.svg#house" />
-<img src="lucide-static/sprite.svg#home" />
+```
 
-<!-- or -->
+#### Inline usage:
+
+```html
 <svg
   width="24"
   height="24"
@@ -105,12 +136,13 @@ You may need additional loader for this.
   <use href="#alert-triangle" />
 </svg>
 
-<svg>
+<!-- sprite SVG -->
-  ...sprite svg
+<svg>...</svg>
-</svg>
 ```
 
-If you'd prefer, you can use CSS to hold your base SVG properties
+#### Inline with CSS helper class
+
+If you'd prefer, you can use CSS to hold your base SVG properties:
 
 ```css
 .lucide-icon {
@@ -124,47 +156,71 @@ If you'd prefer, you can use CSS to hold your base SVG properties
 }
 ```
 
-and update the SVG as follows
+...and update the SVG as follows:
 
 ```xml
 <svg
   xmlns="http://www.w3.org/2000/svg"
   class="lucide-icon"
 >
-<use
+  <use href="#triangle-alert" />
-    href="#alert-triangle"
-  />
-</svg>
-<svg>
-  ...sprite svg
 </svg>
+
+<!-- sprite SVG -->
+<svg>...</svg>
 ```
 
-### Icon Font
+## Icon font
 
-```css
+:::danger
+[Not intended for production use.](#production-warning)
+:::
+
+Lucide icons are also available as a web font. To use them, you first need to include the corresponding stylesheet:
+
+::: code-group
+
+```css [Vite]
+@import 'lucide-static/font/lucide.css';
+```
+
+```css [Webpack]
 @import ('~lucide-static/font/lucide.css');
 ```
 
-```html
+```html [CDN]
-<div class="icon-home"></div>
+<link rel="stylesheet" href="https://unpkg.com/lucide-static@latest/font/lucide.css" />
 ```
 
-### Node.js
+```html [Static asset]
+<link rel="stylesheet" href="/your/path/to/lucide.css" />
+```
 
-To use lucide icons in your Nodejs project you can import each icon as:
+:::
+
+Once included, use the format `icon-{kebab-case-name}`. You can copy icon names from the [Lucide Icons page](https://lucide.dev/icons).
+
+```html
+<div class="icon-house"></div>
+```
+
+If you're not using a package manager, you can download the font files directly from the [latest release](https://github.com/lucide-icons/lucide/releases/latest).
+
+## Node.js
+
+You can also import Lucide icons in Node.js (CommonJS) projects:
 
 ```js
-const { messageSquare } = require('lucide-static/lib');
+const {messageSquare} = require('lucide-static/lib');
 ```
 
 > Note: Each icon name is in camelCase.
 
-#### Example in node.js project
+#### Express app example in Node.js
 
 ```js
 const express = require('express');
-const { messageSquare } = require('lucide-static/lib');
+const {messageSquare} = require('lucide-static/lib');
 const app = express();
 const port = 3000;
 
@@ -177,7 +233,7 @@ app.get('/', (req, res) => {
       </head>
       <body>
         <h1>Lucide Icons</h1>
-        <p>This is a lucide icon ${messageSquare}</p>
+        <p>This is a Lucide icon ${messageSquare}</p>
 
       </body>
     </html>

docs/guide/packages/lucide-svelte.md

@@ -7,18 +7,22 @@ Implementation of the lucide icon library for svelte applications.
 ::: code-group
 
 ```sh [pnpm]
-pnpm install lucide-svelte
+pnpm add @lucide/svelte
 ```
 
 ```sh [yarn]
-yarn add lucide-svelte
+yarn add @lucide/svelte
 ```
 
 ```sh [npm]
-npm install lucide-svelte
+npm install @lucide/svelte
 ```
 
+```sh [bun]
+bun add @lucide/svelte
+```
 :::
+> `@lucide/svelte` is only for Svelte 5, for Svelte 4 use the `lucide-svelte` package.
 
 ## How to use
 
@@ -32,7 +36,7 @@ Default usage:
 
 ```svelte
 <script>
-  import { Skull } from 'lucide-svelte';
+  import { Skull } from '@lucide/svelte';
 </script>
 
 <Skull />
@@ -42,20 +46,20 @@ Additional props can be passed to adjust the icon:
 
 ```svelte
 <script>
-  import { Camera } from 'lucide-svelte';
+  import { Camera } from '@lucide/svelte';
 </script>
 
 <Camera color="#ff3e98" />
 ```
 
-For faster builds and load times, you can import icons directly from the `lucide-svelte/icons` directory:
+For faster builds and load times, you can import icons directly from the `@lucide/svelte/icons` directory:
 
 ```svelte
 <script>
-  import AlertCircle from 'lucide-svelte/icons/alert-circle';
+  import CircleAlert from '@lucide/svelte/icons/circle-alert';
 </script>
 
-<AlertCircle color="#ff3e98" />
+<CircleAlert color="#ff3e98" />
 ```
 
 ## Props
@@ -73,7 +77,7 @@ To customize the appearance of an icon, you can pass custom properties as props
 
 ```svelte
 <script>
-  import { Phone } from 'lucide-svelte';
+  import { Phone } from '@lucide/svelte';
 </script>
 
 <Phone fill="#333" />
@@ -87,60 +91,140 @@ The package includes type definitions for all icons. This is useful if you want
 
 ### TypeScript Example
 
-```svelte
+::: code-group
+
+```svelte [Svelte 5]
 <script lang="ts">
-  import Home from 'lucide-svelte/icons/home';
+  import { Home, Library, Cog, type Icon as IconType } from '@lucide/svelte';
-  import Library from 'lucide-svelte/icons/library';
-  import Cog from 'lucide-svelte/icons/cog';
-  import type { ComponentType } from 'svelte';
-  import type { Icon } from 'lucide-svelte';
 
   type MenuItem = {
     name: string;
     href: string;
-    icon: ComponentType<Icon>;
+    icon: typeof IconType;
-  }
+  };
 
   const menuItems: MenuItem[] = [
     {
       name: 'Home',
       href: '/',
-      icon: Home,
+      icon: Home
     },
     {
       name: 'Blog',
       href: '/blog',
-      icon: Library,
+      icon: Library
     },
     {
       name: 'Projects',
       href: '/projects',
-      icon: Cog,
+      icon: Cog
     }
   ];
 </script>
 
 {#each menuItems as item}
+  {@const Icon = item.icon}
   <a href={item.href}>
-   <svelte:component this={item.icon} />
+    <Icon />
     <span>{item.name}</span>
   </a>
 {/each}
 ```
 
+```svelte [Svelte 4]
+<script lang="ts">
+  import { Home, Library, Cog, type Icon } from '@lucide/svelte';
+  import type { ComponentType } from 'svelte';
+
+  type MenuItem = {
+    name: string;
+    href: string;
+    icon: ComponentType<Icon>;
+  };
+
+  const menuItems: MenuItem[] = [
+    {
+      name: 'Home',
+      href: '/',
+      icon: Home
+    },
+    {
+      name: 'Blog',
+      href: '/blog',
+      icon: Library
+    },
+    {
+      name: 'Projects',
+      href: '/projects',
+      icon: Cog
+    }
+  ];
+</script>
+
+{#each menuItems as item}
+  {@const Icon = item.icon}
+  <a href={item.href}>
+    <Icon />
+    <span>{item.name}</span>
+  </a>
+{/each}
+
+```
+:::
+
 ### JSDoc Example
 
-```svelte
+::: code-group
+
+```svelte [Svelte 5]
 <script>
-  import Home from 'lucide-svelte/icons/home';
+  import { Home, Library, Cog } from '@lucide/svelte';
-  import Library from 'lucide-svelte/icons/library';
-  import Cog from 'lucide-svelte/icons/cog';
 
   /**
    * @typedef {Object} MenuItem
    * @property {string} name
    * @property {string} href
-   * @property {import('svelte').ComponentType<import('lucide-svelte').Icon>} icon
+   * @property {typeof import('@lucide/svelte').Icon} icon
+   */
+
+  /** @type {MenuItem[]} */
+  const menuItems = [
+    {
+      name: 'Home',
+      href: '/',
+      icon: Home
+    },
+    {
+      name: 'Blog',
+      href: '/blog',
+      icon: Library
+    },
+    {
+      name: 'Projects',
+      href: '/projects',
+      icon: Cog
+    }
+  ];
+</script>
+
+{#each menuItems as item}
+  {@const Icon = item.icon}
+  <a href={item.href}>
+    <Icon />
+    <span>{item.name}</span>
+  </a>
+{/each}
+```
+
+```svelte [Svelte 4]
+<script>
+  import { Home, Library, Cog } from '@lucide/svelte';
+
+  /**
+   * @typedef {Object} MenuItem
+   * @property {string} name
+   * @property {string} href
+   * @property {import('svelte').ComponentType<import('@lucide/svelte').Icon>} icon
    */
 
   /** @type {MenuItem[]} */
@@ -162,8 +246,18 @@ The package includes type definitions for all icons. This is useful if you want
     }
   ];
 </script>
+
+{#each menuItems as item}
+  {@const Icon = item.icon}
+  <a href={item.href}>
+    <Icon />
+    <span>{item.name}</span>
+  </a>
+{/each}
 ```
 
+:::
+
 For more details about typing the `svelte:component` directive, see the [Svelte documentation](https://svelte.dev/docs/typescript#types-componenttype).
 
 ## With Lucide lab or custom icons
@@ -179,11 +273,11 @@ This creates a single icon based on the iconNode passed and renders a Lucide ico
 
 ```svelte
 <script>
-import { Icon } from 'lucide-svelte';
+import { Icon } from '@lucide/svelte';
-import { burger, sausage } from '@lucide/lab';
+import { pear, sausage } from '@lucide/lab';
 </script>
 
-<Icon iconNode={burger} />
+<Icon iconNode={pear} />
 <Icon iconNode={sausage} color="red"/>
 ```
 
@@ -197,15 +291,30 @@ The example below imports all ES Modules, so exercise caution when using it. Imp
 
 ### Icon Component Example
 
-```svelte
+::: code-group
+
+```svelte [Svelte 5]
 <script>
-  import * as icons from 'lucide-svelte';
+  import * as icons from '@lucide/svelte';
+  let { name, ...props } = $props();
+
+  const Icon = icons[name];
+</script>
+
+<Icon {...props} />
+```
+
+```svelte [Svelte 4]
+<script>
+  import * as icons from '@lucide/svelte';
   export let name;
 </script>
 
-<svelte:component this="{icons[name]}" {...$$props} />
+<svelte:component this={icons[name]} {...$$props} />
 ```
 
+:::
+
 #### Using the Icon Component
 
 ```svelte

docs/guide/packages/lucide-vue-next.md

@@ -2,12 +2,6 @@
 
 Implementation of the lucide icon library for Vue 3 applications.
 
-## Vue 3 or Vue 2
-
-::: tip
-This version of lucide is for Vue 3, For Vue 2 got to [lucide-vue ->](lucide-vue)
-:::
-
 ## Installation
 
 ::: code-group
@@ -24,6 +18,10 @@ yarn add lucide-vue-next
 npm install lucide-vue-next
 ```
 
+```sh [bun]
+bun add lucide-vue-next
+```
+
 :::
 
 ## How to use
@@ -56,7 +54,7 @@ import { Camera } from 'lucide-vue-next';
 | `size`                  | *number*  | 24           |
 | `color`                 | *string*  | currentColor |
 | `stroke-width`          | *number*  | 2            |
-| `absolute-stroke-width` | *boolean* | false        |
+| `absoluteStrokeWidth`   | *boolean* | false        |
 | `default-class`         | *string*  | lucide-icon  |
 
 ### Applying props
@@ -83,11 +81,11 @@ This creates a single icon based on the iconNode passed and renders a Lucide ico
 ```vue
 <script setup>
 import { Icon } from 'lucide-vue-next';
-import { burger } from '@lucide/lab';
+import { baseball } from '@lucide/lab';
 </script>
 
 <template>
-  <Icon :iconNode="burger" />
+  <Icon :iconNode="baseball" />
 </template>
 ```
 

docs/guide/packages/lucide-vue.md

@@ -2,15 +2,8 @@
 
 Implementation of the lucide icon library for Vue applications.
 
-::: warning
+::: danger
-This package will be deprecated end of 2023. Vue v2 will be EOF at the end of 2023 See [Announcement](https://v2.vuejs.org/lts/). We recommend to migrate to Vue 3.
+This package is deprecated. Vue 2 is EOF  See [Announcement](https://v2.vuejs.org/eol/). Migrate to Vue 3.
-The Lucide Vue package will be only maintained for Vue 3 after the deprecation.
-:::
-
-## Vue 2 or Vue 3
-
-::: tip
-This version of lucide is for Vue 2, For Vue 3 go to [lucide-vue-next ->](lucide-vue-next)
 :::
 
 ## Installation
@@ -29,6 +22,10 @@ yarn add lucide-vue
 npm install lucide-vue
 ```
 
+```sh [bun]
+bun add lucide-vue
+```
+
 :::
 
 ## How to use
@@ -63,7 +60,7 @@ Additional props can be passed to adjust the icon:
 | `size`                  | *number*  | 24           |
 | `color`                 | *string*  | currentColor |
 | `stroke-width`          | *number*  | 2            |
-| `absolute-stroke-width` | *boolean* | false        |
+| `absoluteStrokeWidth`   | *boolean* | false        |
 | `default-class`         | *string*  | lucide-icon  |
 
 ### Applying props

docs/guide/packages/lucide.md

@@ -20,6 +20,10 @@ yarn add lucide
 npm install lucide
 ```
 
+```sh [bun]
+bun add lucide
+```
+
 :::
 
 ### CDN
@@ -122,11 +126,23 @@ import { createElement, Menu } from 'lucide';
 
 const menuIcon = createElement(Menu); // Returns HTMLElement (svg)
 
-// set custom attributes with browser native functions
+// Append HTMLElement in the DOM
-menuIcon.setAttribute('stroke', '#333');
+const myApp = document.getElementById('app');
-menuIcon.classList.add('my-icon-class');
+myApp.appendChild(menuIcon);
+```
 
-// Append HTMLElement in webpage
+#### Custom Element binding with custom attributes
+
+```js
+import { createElement, Menu } from 'lucide';
+
+const menuIcon = createElement(Menu, {
+  class: ['my-custom-class', 'icon'],
+  'stroke-width': 1,
+  stroke: '#333'
+}); // Returns HTMLElement (svg)
+
+// Append HTMLElement in the DOM
 const myApp = document.getElementById('app');
 myApp.appendChild(menuIcon);
 ```
@@ -137,11 +153,11 @@ myApp.appendChild(menuIcon);
 They can be used in the same way as the official icons.
 
 ```js
-import { burger } from '@lucide/lab';
+import { coconut } from '@lucide/lab';
 
 createIcons({
   icons: {
-    burger
+    coconut
   }
 });
 ```

docs/icons/[name].md

@@ -14,13 +14,13 @@ import IconPreview from '~/.vitepress/theme/components/icons/IconPreview.vue'
 import IconPreviewSmall from '~/.vitepress/theme/components/icons/IconPreviewSmall.vue'
 import IconInfo from '~/.vitepress/theme/components/icons/IconInfo.vue'
 import IconContributors from '~/.vitepress/theme/components/icons/IconContributors.vue'
+import IconShowcase from '~/.vitepress/theme/components/icons/IconShowcase.vue'
 import RelatedIcons from '~/.vitepress/theme/components/icons/RelatedIcons.vue'
 import CodeGroup from '~/.vitepress/theme/components/base/CodeGroup.vue'
 import Badge from '~/.vitepress/theme/components/base/Badge.vue'
 import Label from '~/.vitepress/theme/components/base/Label.vue'
-import VPButton from 'vitepress/dist/client/theme-default/components/VPButton.vue';
 import { data } from './codeExamples.data'
-import { camelCase, startCase } from 'lodash-es'
+import { toCamelCase, toPascalCase } from '@lucide/shared'
 import { satisfies } from 'semver'
 
 const { params } = useData()
@@ -31,8 +31,8 @@ const tabs = computed(() => data.codeExamples?.map(
 
 const codeExample = computed(() => data.codeExamples?.map(
     (codeExample) => {
-      const pascalCaseName = startCase(camelCase( params.value.name)).replace(/\s/g, '')
+      const pascalCaseName = toPascalCase( params.value.name)
-      const camelCaseName = camelCase(params.value.name)
+      const camelCaseName = toCamelCase(params.value.name)
 
       return codeExample.code
         .replace(/\$(?:<[^>]+>)*PascalCase/g, pascalCaseName)
@@ -105,6 +105,11 @@ function releaseTagLink(version) {
   </div>
 </div>
 
+<IconShowcase
+  :name="params.name"
+  :iconNode="params.iconNode"
+/>
+
 <RelatedIcons
   v-if="params.relatedIcons"
   :icons="params.relatedIcons"
@@ -234,3 +239,12 @@ function releaseTagLink(version) {
     }
   }
 </style>
+
+<style>
+section h2.title {
+  text-align: center;
+  font-weight: 500;
+  margin-block-end: 64px;
+  padding-top: 32px;
+}
+</style>

docs/images/24px-24px.svg

@@ -48,10 +48,12 @@
     <path d="M340 120v240" stroke="#D8D8D9" stroke-width=".5"/>
     <path d="M120 350h240" stroke="#D8D8D9" stroke-width=".5"/>
     <path d="M350 120v240" stroke="#D8D8D9" stroke-width=".5"/>
-  </g>
+</g>
-  <path d="m240 140-100 50 100 50 100-50-100-50Z" stroke="#3C3C43" stroke-width="20" stroke-linecap="round" stroke-linejoin="round"/>
+<g id="embed-lucide-layers" stroke="#3C3C43" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" transform="translate(120 120), scale(10)">
-  <path d="m140 290 100 50 100-50" stroke="#3C3C43" stroke-width="20" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M12.83 2.18a2 2 0 0 0-1.66 0L2.6 6.08a1 1 0 0 0 0 1.83l8.58 3.91a2 2 0 0 0 1.66 0l8.58-3.9a1 1 0 0 0 0-1.83z" />
-  <path d="m140 240 100 50 100-50" stroke="#3C3C43" stroke-width="20" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M2 12a1 1 0 0 0 .58.91l8.6 3.91a2 2 0 0 0 1.65 0l8.58-3.9A1 1 0 0 0 22 12" />
+  <path d="M2 17a1 1 0 0 0 .58.91l8.6 3.91a2 2 0 0 0 1.65 0l8.58-3.9A1 1 0 0 0 22 17" />
+</g>
   <g opacity=".5" stroke="#fff" stroke-width="3">
     <path d="M120 92v16"/>
     <path d="M360 92v16"/>