feat(icons): added shield-cog icon (#3902)

* Added icons/shield-cog.svg

* Added icons/shield-cog.json

* Added icons/shield-cog-2.svg

* Added icons/shield-cog-2.json

* name issue fixed

* Add shield-cog-corner.svg icon file

* Add shield-cog-corner.json icon file

* Rename shield-cog-mid.svg to shield-cog.svg

* Add shield-cog.json file

---------

Co-authored-by: Rajnish Mehta <43362941-KnarliX@users.noreply.replit.com>

.cspell/custom-words.txt

@@ -9,9 +9,3 @@ strikethrough
 touchpad
 ungroup
 toc
-
-# Brands
-codepen
-codesandbox
-dribbble
-x.com

.eslintignore

@@ -8,3 +8,4 @@ node_modules
 docs/images
 docs/**/examples/
 packages/lucide-react/dynamicIconImports.js
+packages/angular/.angular

.github/ISSUE_TEMPLATE/01_icon_request.yml

@@ -7,8 +7,10 @@ body:
       value: |
         Before submitting an icon request check if it has already been requested. If there is an open request, please add a 👍.
 
-        **Important note**: No new brand logos are allowed, see https://github.com/lucide-icons/lucide/issues/670.
-        Existing brand icons will also be phased out. For brand icons, consider using https://simpleicons.org, which offers purpose-built SVGs that are also on a 24×24px grid.
+        > [!CAUTION]
+        > New brand logos are **not** allowed, see our official statement: https://github.com/lucide-icons/lucide/blob/main/BRAND_LOGOS_STATEMENT.md.
+        >
+        > Existing brand icons are being phased out. Consider using https://simpleicons.org, which offers purpose-built SVGs that are also on a 24×24px grid.
   - type: input
     id: name
     attributes:
@@ -41,9 +43,9 @@ body:
           required: true
         - label: I have searched existing icons to make sure it does not already exist and I didn't find any.
           required: true
-        - label: I am not requesting a brand logo and the art is not protected by copyright.
+        - label: I am not requesting a brand logo and the art is not protected by copyright, see more at https://github.com/lucide-icons/lucide/blob/main/BRAND_LOGOS_STATEMENT.md
           required: true
-        - label: I am not requesting an icon that includes religious, political imagery or hate symbols.
+        - label: I am not requesting an icon that includes religious, war/violence related, political imagery or hate symbols.
           required: true
         - label: I have provided appropriate use cases for the icon(s) requested.
           required: true

.github/ISSUE_TEMPLATE/02_bug_report.yml

@@ -13,16 +13,21 @@ body:
       description: Which Lucide packages are affected? You may select more than one.
       options:
         - label: lucide
-        - label: lucide-angular
+        - label: lucide-angular (old version)
+        - label: '@lucide/angular (new version)'
+        - label: '@lucide/astro'
         - label: lucide-flutter
         - label: lucide-preact
         - label: lucide-react
         - label: lucide-react-native
         - label: lucide-solid
-        - label: lucide-svelte
+        - label: lucide-static
+        - label: lucide-svelte (old version)
+        - label: '@lucide/svelte (new version)'
         - label: lucide-vue
         - label: lucide-vue-next
         - label: lucide-astro
+        - label: '@lucide/icons'
         - label: Figma plugin
         - label: source/main
         - label: other/not relevant

.github/ISSUE_TEMPLATE/04_feature_request.yml

@@ -13,19 +13,25 @@ body:
       description: Which Lucide project do you wish this feature were added to? You may select more than one.
       options:
         - label: lucide
-        - label: lucide-angular
+        - label: lucide-angular (old version)
+        - label: '@lucide/angular (new version)'
+        - label: '@lucide/astro'
         - label: lucide-flutter
         - label: lucide-preact
         - label: lucide-react
         - label: lucide-react-native
         - label: lucide-solid
-        - label: lucide-svelte
+        - label: lucide-static
+        - label: lucide-svelte (old version)
+        - label: '@lucide/svelte (new version)'
         - label: lucide-vue
         - label: lucide-vue-next
         - label: lucide-astro
+        - label: '@lucide/icons'
         - label: Figma plugin
         - label: all JS packages
         - label: site
+        - label: other/not relevant
     validations:
       required: true
   - type: textarea

.github/labeler.yml

@@ -36,62 +36,69 @@
       - any-glob-to-any-file:
           - 'packages/lucide/*'
 
-# For changes in the lucide React package
+# For changes in the Lucide React package
 ⚛️ react package:
   - changed-files:
       - any-glob-to-any-file:
           - 'packages/lucide-react/*'
 
-# For changes in the lucide React Native package
+# For changes in the Lucide React Native package
 ⚛️ react native package:
   - changed-files:
       - any-glob-to-any-file:
           - 'packages/lucide-react-native/*'
 
-# For changes in the lucide vue packages
+# For changes in the Lucide vue packages
 💎 vue package:
   - changed-files:
       - any-glob-to-any-file:
           - 'packages/lucide-vue/*'
           - 'packages/lucide-vue-next/*'
 
-# For changes in the lucide angular package
+# For changes in the Lucide angular package
 🅰️ angular package:
   - changed-files:
       - any-glob-to-any-file:
+          - 'packages/angular/*'
           - 'packages/lucide-angular/*'
 
-# For changes in the lucide preact package
+# For changes in the Lucide preact package
 ⚛️ preact package:
   - changed-files:
       - any-glob-to-any-file:
           - 'packages/lucide-preact/*'
 
-# For changes in the lucide svelte package
+# For changes in the Lucide svelte package
 🧣 svelte package:
   - changed-files:
       - any-glob-to-any-file:
           - 'packages/lucide-svelte/*'
 
-# For changes in the lucide solid package
+# For changes in the Lucide solid package
 🪝 solid package:
   - changed-files:
       - any-glob-to-any-file:
           - 'packages/lucide-solid/*'
 
-# For changes in the lucide astro package
+# 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
+# For changes in the @lucide/icons package
+❇️ lucide-icons:
+  - changed-files:
+      - any-glob-to-any-file:
+          - 'packages/lucide-icons/*'
+
+# For changes in the Lucide static package
 🪨 static package:
   - changed-files:
       - any-glob-to-any-file:
           - 'packages/lucide-static/*'
 
-# For changes in the lucide flutter package
+# For changes in the Lucide flutter package
 🏹 flutter package:
   - changed-files:
       - any-glob-to-any-file:

.github/pull_request_template.md

@@ -25,10 +25,12 @@ Common scopes: icons, docs, studio, site, dev
 
 ### Concept <!-- ONLY for new icons -->
 <!-- All of these requirements must be fulfilled. -->
+<!-- IMPORTANT! Please read our official statement on brand logos in Lucide: -->
+<!-- https://github.com/lucide-icons/lucide/blob/main/BRAND_LOGOS_STATEMENT.md -->
 - [ ] I have provided valid use cases for each icon.
-- [ ] I have not added any a brand or logo icon.
+- [ ] I have [not added any brand or logo icon](https://github.com/lucide-icons/lucide/blob/main/BRAND_LOGOS_STATEMENT.md).
 - [ ] I have not used any hate symbols.
-- [ ] I have not included any religious or political imagery.
+- [ ] I have not included any religious, war/violence related or political imagery.
 
 ### Author, credits & license<!-- ONLY for new icons. -->
 <!-- Please choose one of the following, and put an "x" next to it. -->

.github/workflows/angular.yml

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

.github/workflows/ci.yml

@@ -7,17 +7,40 @@ on:
     paths:
       - icons/**/*.svg
 
+  workflow_dispatch:
+    inputs:
+      version:
+        description: Version
+        required: true
+      tag:
+        required: true
+        description: NPM tag
+        default: 'latest'
+        type: choice
+        options:
+          - latest
+          - next
+          - beta
+          - alpha
+
+permissions:
+  id-token: write # Required for OIDC
+  contents: write
+
+# This is added to make sure we wait until last release is done, this is needed for the font-build process
+concurrency:
+  group: continuous-integration
+
 jobs:
   create-release:
-    if: github.repository == 'lucide-icons/lucide' && startsWith(github.event.head_commit.message, 'feat(icons)')
+    if: github.repository == 'lucide-icons/lucide' && startsWith(github.event.head_commit.message, 'feat(icons)') && github.event_name != 'workflow_dispatch'
     runs-on: ubuntu-latest
     outputs:
       VERSION: ${{ steps.new-version.outputs.NEW_VERSION }}
-
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -30,27 +53,21 @@ jobs:
 
       - name: Get latest tag
         id: latest-tag
-        run: echo "LATEST_TAG=$(git describe --tags `git rev-list --tags --max-count=1`)" >> $GITHUB_OUTPUT
+        run: echo "LATEST_TAG=$(git tag --sort=-v:refname | grep -E '^[0-9]+\.[0-9]+\.[0-9]+$' | head -n 1)" >> $GITHUB_OUTPUT
+
+      - name: Log latest tag
+        run: echo '${{ steps.latest-tag.outputs.LATEST_TAG }}'
 
       - name: Check if we can patch
-        run: .github/workflows/version-up.sh --minor
+        run: pnpm semver $LATEST_TAG -i minor
+        env:
+          LATEST_TAG: ${{ steps.latest-tag.outputs.LATEST_TAG }}
 
       - name: Create new version
         id: new-version
-        run: echo "NEW_VERSION=$(.github/workflows/version-up.sh --minor)" >> $GITHUB_OUTPUT
-
-      - name: Create change log
-        id: change-log
-        run: |
-          CHANGE_LOG=$(pnpm run generate:changelog --old-tag=${{ steps.latest-tag.outputs.LATEST_TAG }})
-          CHANGE_LOG=$(tail -n +5 <<< $CHANGE_LOG)
-          echo $CHANGE_LOG
-          EOF=$(dd if=/dev/urandom bs=15 count=1 status=none | base64)
-          echo "CHANGE_LOG<<$EOF" >> $GITHUB_OUTPUT
-          echo "$CHANGE_LOG" >> $GITHUB_OUTPUT
-          echo "$EOF" >> $GITHUB_OUTPUT
+        run: echo "NEW_VERSION=$(pnpm semver $LATEST_TAG -i minor)" >> $GITHUB_OUTPUT
         env:
-          GITHUB_API_KEY: ${{ secrets.GITHUB_TOKEN }}
+          LATEST_TAG: ${{ steps.latest-tag.outputs.LATEST_TAG }}
 
       - name: Check output
         run: |
@@ -64,38 +81,6 @@ jobs:
           name: Version ${{ steps.new-version.outputs.NEW_VERSION }}
           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'
     needs: create-release
@@ -103,3 +88,11 @@ jobs:
     secrets: inherit
     with:
       version: ${{ needs.create-release.outputs.VERSION }}
+
+  dispatch-release:
+    if: github.event_name == 'workflow_dispatch'
+    uses: './.github/workflows/release.yml'
+    secrets: inherit
+    with:
+      version: ${{ inputs.version }}
+      tag: ${{ inputs.tag }}

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

@@ -1,4 +1,4 @@
-name: Close Issue with Banned Phrases
+name: Close Icon Requests with Brand Terms
 
 on:
   issues:
@@ -11,25 +11,38 @@ jobs:
       issues: write
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
-      - name: Check for blocked phrases in issue title
+      - name: Load stopwords from JSON & check issue title & body
+        if: contains(github.event.issue.labels.*.name, '🙌 icon request')
         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")
+          ISSUE_BODY=$(jq -r '.issue.body // ""' "$GITHUB_EVENT_PATH")
+          ICON_NAME_SECTION=$(printf '%s\n' "$ISSUE_BODY" | awk '/### Icon name/{flag=1; next} /^### /{flag=0} flag')
 
-          # 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.
+          jq -r 'to_entries[] | "\(.key) \(.value)"' brand-stopwords.json | while read -r KEY VALUE; do
+            SAFE_KEY=$(printf '%s\n' "$KEY" | sed 's/[][\.^$*]/\\&/g')
+            SAFE_VALUE=$(printf '%s\n' "$VALUE" | sed 's/[][\.^$*]/\\&/g')
 
-          Read more about brand guideline rules at [We're not accepting new Brand icons #670](https://github.com/lucide-icons/lucide/issues/670).
+            if echo "$ISSUE_TITLE" | grep -iqE "$SAFE_KEY|$SAFE_VALUE" || \
+              { [ -n "$ICON_NAME_SECTION" ] && echo "$ICON_NAME_SECTION" | grep -iqE "$SAFE_KEY|$SAFE_VALUE"; }; then
+
+              gh issue close ${{ github.event.issue.number }} \
+                --reason "not planned" \
+                --comment "It looks like this request is about **${VALUE}**, which is a brand logo.
+
+          Lucide **does not accept** brand logos, and we do not plan to add them in the future. This is due to a combination of **legal restrictions**, **design consistency concerns**, and **practical maintenance reasons**.
+
+          [Click here to read our official statement about brand logos in Lucide.](./BRAND_LOGOS_STATEMENT.md)
+
+          You can [search for similar issues.](https://github.com/lucide-icons/lucide/issues?q=is%3Aissue+${VALUE})
+
+          We’re always happy to help on [Discord](https://discord.gg/EH6nSts)."
 
-          Always happy to help on [Discord](https://discord.gg/EH6nSts)."
               gh issue lock ${{ github.event.issue.number }} --reason spam
-              exit 1
+              exit 0
             fi
           done
-        env:
-          GH_TOKEN: ${{ github.token }}
+
+env:
+  GH_TOKEN: ${{ github.token }}

.github/workflows/icons.yml

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

.github/workflows/labeler.yml

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

.github/workflows/lint-code.yml

@@ -9,9 +9,9 @@ jobs:
   lint-code:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'

.github/workflows/linting-icons.yml

@@ -1,6 +1,9 @@
 name: Linting Icons
 
 on:
+  push:
+    branches:
+      - next
   pull_request:
     paths:
       - 'icons/*'
@@ -13,8 +16,8 @@ jobs:
     permissions:
       contents: read
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
         with:
           node-version-file: 'package.json'
       - name: Get changed files
@@ -34,6 +37,6 @@ jobs:
     permissions:
       contents: read
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - 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

@@ -1,6 +1,9 @@
 name: Lucide Angular checks
 
 on:
+  push:
+    branches:
+      - next
   pull_request:
     paths:
       - packages/lucide-angular/**
@@ -11,9 +14,9 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -27,9 +30,9 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'

.github/workflows/lucide-astro.yml

@@ -1,6 +1,9 @@
 name: Lucide Astro Checks
 
 on:
+  push:
+    branches:
+      - next
   pull_request:
     paths:
       - packages/astro/**
@@ -12,9 +15,9 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: pnpm/action-setup@v2
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           node-version-file: 'package.json'
           cache: 'pnpm'

.github/workflows/lucide-font.yml

@@ -1,6 +1,9 @@
 name: Lucide font checks
 
 on:
+  push:
+    branches:
+      - next
   pull_request:
     paths:
       - tools/build-font/**
@@ -10,9 +13,9 @@ jobs:
   lucide-font:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -20,9 +23,6 @@ jobs:
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
 
-      - name: Outline svg Icons
-        run: pnpm build:outline-icons
-
       - name: Create font in ./lucide-font
         run: pnpm build:font
 

.github/workflows/lucide-preact.yml

@@ -1,6 +1,9 @@
 name: Lucide Preact Checks
 
 on:
+  push:
+    branches:
+      - next
   pull_request:
     paths:
       - packages/lucide-preact/**
@@ -13,9 +16,9 @@ jobs:
   lucide-preact:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'

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

@@ -1,6 +1,9 @@
 name: Lucide React Native checks
 
 on:
+  push:
+    branches:
+      - next
   pull_request:
     paths:
       - packages/lucide-react-native/**
@@ -13,9 +16,9 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -29,9 +32,9 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'

.github/workflows/lucide-react.yml

@@ -1,6 +1,9 @@
 name: Lucide React Checks
 
 on:
+  push:
+    branches:
+      - next
   pull_request:
     paths:
       - packages/lucide-react/**
@@ -14,9 +17,9 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -30,9 +33,9 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'

.github/workflows/lucide-shared.yml

@@ -1,6 +1,9 @@
 name: Lucide Shared Checks
 
 on:
+  push:
+    branches:
+      - next
   pull_request:
     paths:
       - packages/shared/**
@@ -10,9 +13,9 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'

.github/workflows/lucide-solid.yml

@@ -1,6 +1,9 @@
 name: Lucide Solid Checks
 
 on:
+  push:
+    branches:
+      - next
   pull_request:
     paths:
       - packages/lucide-solid/**
@@ -13,9 +16,9 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -29,9 +32,9 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'

.github/workflows/lucide-static.yml

@@ -11,9 +11,9 @@ jobs:
   lucide-static:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'

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

@@ -1,6 +1,9 @@
 name: Lucide Svelte 5 checks
 
 on:
+  push:
+    branches:
+      - next
   pull_request:
     paths:
       - packages/svelte/**
@@ -13,9 +16,9 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -29,9 +32,9 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -41,3 +44,19 @@ jobs:
 
       - name: Test
         run: pnpm --filter @lucide/svelte test
+
+  typecheck:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v6
+        with:
+          cache: 'pnpm'
+          node-version-file: 'package.json'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Test
+        run: pnpm --filter @lucide/svelte typecheck

.github/workflows/lucide-svelte.yml

@@ -1,6 +1,9 @@
 name: Lucide Svelte checks
 
 on:
+  push:
+    branches:
+      - next
   pull_request:
     paths:
       - packages/lucide-svelte/**
@@ -13,9 +16,9 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -29,9 +32,9 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'

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

@@ -1,6 +1,9 @@
 name: Lucide Vue Next checks
 
 on:
+  push:
+    branches:
+      - next
   pull_request:
     paths:
       - packages/lucide-vue-next/**
@@ -13,9 +16,9 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -29,9 +32,9 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'

.github/workflows/lucide-vue.yml

@@ -0,0 +1,46 @@
+name: Lucide Vue checks
+
+on:
+  push:
+    branches:
+      - next
+  pull_request:
+    paths:
+      - packages/lucide-vue/**
+      - 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/vue 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/vue test

.github/workflows/lucide.yml

@@ -1,6 +1,9 @@
 name: Lucide checks
 
 on:
+  push:
+    branches:
+      - next
   pull_request:
     paths:
       - packages/lucide/**
@@ -12,9 +15,9 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -28,9 +31,9 @@ jobs:
   test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'

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

@@ -14,8 +14,8 @@ jobs:
       pull-requests: write
 
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
         with:
           node-version-file: 'package.json'
 
@@ -25,7 +25,7 @@ jobs:
         with:
           files: icons/*.svg
 
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
       - name: Install svgson for code preview (safer and faster than installing all deps)
         run: npm install svgson@5.3.1 --force
 

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

@@ -16,11 +16,11 @@ jobs:
     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
+      - uses: actions/checkout@v6
         with:
           repository: lucide-icons/lucide
       - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'

.github/workflows/release.yml

@@ -11,16 +11,21 @@ on:
         required: true
         description: Version
         type: string
+      tag:
+        description: NPM tag
+        default: 'next' # set to latest after v1 release
+        type: string
 
-  workflow_dispatch:
-    inputs:
-      version:
-        description: Version
-        required: true
+permissions:
+  id-token: write # Required for OIDC
+  contents: write
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
 
 jobs:
-  pre-release:
-    if: github.repository == 'lucide-icons/lucide' && contains('["ericfennis", "karsa-mistmere"]', github.actor)
+  prepare:
+    if: github.repository == 'lucide-icons/lucide' && contains('["ericfennis", "karsa-mistmere", "jguddas"]', github.actor)
     runs-on: ubuntu-latest
     outputs:
       VERSION: ${{ steps.get_version.outputs.VERSION }}
@@ -37,9 +42,10 @@ jobs:
   release:
     if: github.repository == 'lucide-icons/lucide'
     runs-on: ubuntu-latest
-    needs: pre-release
+    needs: prepare
     permissions:
-      id-token: write
+      id-token: write # Required for OIDC
+      contents: read
     strategy:
       fail-fast: false
       matrix:
@@ -48,19 +54,18 @@ jobs:
             'lucide',
             'lucide-react',
             'lucide-react-native',
-            'lucide-vue',
-            'lucide-vue-next',
-            'lucide-angular',
             'lucide-preact',
             'lucide-solid',
-            'lucide-svelte',
-            '@lucide/astro',
-            '@lucide/svelte',
+            'angular',
+            'astro',
+            'icons',
+            'svelte',
+            'vue',
           ]
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -68,34 +73,37 @@ jobs:
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
 
-      - name: Set Auth Token
-        run: npm config set //registry.npmjs.org/:_authToken ${{ inputs.NPM_TOKEN || secrets.NPM_TOKEN }}
-
       - name: Set new version
-        run: pnpm --filter ${{ matrix.package }} version --new-version ${{ needs.pre-release.outputs.VERSION }} --no-git-tag-version
+        run: pnpm version --new-version ${{ needs.prepare.outputs.VERSION }} --no-git-tag-version
+        working-directory: packages/${{ matrix.package }}
 
       - name: Build
-        run: pnpm --filter ${{ matrix.package }} build
+        run: pnpm build
+        working-directory: packages/${{ matrix.package }}
 
       - name: Test
-        run: pnpm --filter ${{ matrix.package }} test
+        run: pnpm test
+        working-directory: packages/${{ matrix.package }}
 
       - name: Publish
-        run: pnpm --filter ${{ matrix.package }} publish --access public --no-git-checks --ignore-scripts
+        run: pnpm publish --access public --no-git-checks --ignore-scripts --tag ${{ inputs.tag }}
+        working-directory: packages/${{ matrix.package }}
         env:
           NPM_CONFIG_PROVENANCE: true
 
   lucide-static:
     if: github.repository == 'lucide-icons/lucide'
     runs-on: ubuntu-latest
-    needs: [pre-release, lucide-font]
+    needs: [prepare, lucide-font]
     permissions:
-      id-token: write
+      id-token: write # Required for OIDC
+      contents: read
+
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: actions/download-artifact@v4
       - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -103,11 +111,8 @@ jobs:
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
 
-      - name: Set Auth Token
-        run: npm config set //registry.npmjs.org/:_authToken ${{ secrets.NPM_TOKEN }}
-
       - name: Set new version
-        run: pnpm --filter lucide-static version --new-version ${{ needs.pre-release.outputs.VERSION }} --no-git-tag-version
+        run: pnpm --filter lucide-static version --new-version ${{ needs.prepare.outputs.VERSION }} --no-git-tag-version
 
       - name: Move Font
         run: cp -r lucide-font packages/lucide-static/font
@@ -116,18 +121,18 @@ jobs:
         run: pnpm --filter lucide-static build
 
       - name: Publish
-        run: pnpm --filter lucide-static publish --no-git-checks
+        run: pnpm --filter lucide-static publish --no-git-checks --ignore-scripts --tag ${{ inputs.tag }} --access public
         env:
           NPM_CONFIG_PROVENANCE: true
 
   lucide-font:
     if: github.repository == 'lucide-icons/lucide'
     runs-on: ubuntu-latest
-    needs: pre-release
+    needs: prepare
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           cache: 'pnpm'
           node-version-file: 'package.json'
@@ -135,11 +140,10 @@ jobs:
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
 
-      - name: Outline svg Icons
-        run: pnpm build:outline-icons
-
       - name: Create font in ./lucide-font
-        run: pnpm build:font
+        run: pnpm build:font --saveCodePoints
+        env:
+          BLOB_READ_WRITE_TOKEN: ${{ secrets.BLOB_READ_WRITE_TOKEN }}
 
       - name: 'Upload to Artifacts'
         uses: actions/upload-artifact@v4
@@ -148,22 +152,25 @@ jobs:
           path: lucide-font
 
   post-release:
-    if: github.repository == 'lucide-icons/lucide'
+    if: github.repository == 'lucide-icons/lucide' && github.event_name != 'workflow_call'
     runs-on: ubuntu-latest
-    needs: [pre-release, lucide-font]
-
+    needs: [prepare, lucide-font]
+    permissions:
+      id-token: write # Required for OIDC
+      contents: write
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - 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
+          zip -r lucide-font-${{ needs.prepare.outputs.VERSION }}.zip lucide-font
+          zip -r lucide-icons-${{ needs.prepare.outputs.VERSION }}.zip icons
 
       - name: Release zip and fonts
         uses: softprops/action-gh-release@v2
         with:
-          tag_name: ${{ needs.pre-release.outputs.VERSION }}
+          tag_name: ${{ needs.prepare.outputs.VERSION }}
+
           files: |
-            lucide-font-${{ needs.pre-release.outputs.VERSION }}.zip
-            lucide-icons-${{ needs.pre-release.outputs.VERSION }}.zip
+            lucide-font-${{ needs.prepare.outputs.VERSION }}.zip
+            lucide-icons-${{ needs.prepare.outputs.VERSION }}.zip

.github/workflows/request-review.yml

@@ -2,7 +2,8 @@ name: 'Request Review'
 on:
   pull_request_target:
     types: [opened]
-    paths: icons/*.svg
+    paths:
+      - icons/*.svg
 
 jobs:
   request-review:
@@ -12,7 +13,7 @@ jobs:
       contents: read
       pull-requests: write
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
           ref: refs/pull/${{ github.event.pull_request.number }}/merge

.github/workflows/version-up.sh

@@ -1,284 +0,0 @@
-#!/usr/bin/env bash
-## Copyright (C) 2017, Oleksandr Kucherenko
-## Last revisit: 2017-09-29
-
-## get highest version tag for all branches
-function highest_tag(){
-  local TAG=$(git describe --tags `git rev-list --tags --max-count=1`)
-  echo "$TAG"
-}
-
-## extract current branch name
-function current_branch(){
-  ## expected: heads/{branch_name}
-  ## expected: {branch_name}
-    local BRANCH=$(git rev-parse --abbrev-ref HEAD | cut -d"/" -f2)
-    echo "$BRANCH"
-}
-
-## get latest/head commit hash number
-function head_hash(){
-  local COMMIT_HASH=$(git rev-parse --verify HEAD)
-  echo "$COMMIT_HASH"
-}
-
-## extract tag commit hash code, tag name provided by argument
-function tag_hash(){
-  local TAG_HASH=$(git log -1 --format=format:"%H" $1 2>/dev/null | tail -n1)
-  echo "$TAG_HASH"
-}
-
-## get latest revision number
-function latest_revision(){
-  local REV=$(git rev-list --count HEAD 2>/dev/null)
-  echo "$REV"
-}
-
-## parse last found tag, extract it PARTS
-function parse_last(){
-  local position=$(($1-1))
-
-  # two parts found only
-  local SUBS=( ${PARTS[$position]//-/ } )
-  #echo ${SUBS[@]}, size: ${#SUBS}
-
-  # found NUMBER
-  PARTS[$position]=${SUBS[0]}
-  #echo ${PARTS[@]}
-
-  # found SUFFIX
-  if [[ ${#SUBS} -ge 1 ]]; then
-    PARTS[4]=${SUBS[1],,} #lowercase
-    #echo ${PARTS[@]}, ${SUBS[@]}
-  fi
-}
-
-## increment REVISION part, don't touch STAGE
-function increment_revision(){
-  PARTS[3]=$(( PARTS[3] + 1 ))
-  IS_DIRTY=1
-}
-
-## increment PATCH part, reset all other lower PARTS, don't touch STAGE
-function increment_patch(){
-  PARTS[2]=$(( PARTS[2] + 1 ))
-  PARTS[3]=0
-  IS_DIRTY=1
-}
-
-## increment MINOR part, reset all other lower PARTS, don't touch STAGE
-function increment_minor(){
-    PARTS[1]=$(( PARTS[1] + 1 ))
-    PARTS[2]=0
-    PARTS[3]=0
-    IS_DIRTY=1
-}
-
-## increment MAJOR part, reset all other lower PARTS, don't touch STAGE
-function incremet_major(){
-  PARTS[0]="v$(( PARTS[0] + 1 ))"
-  PARTS[1]=0
-  PARTS[2]=0
-  PARTS[3]=0
-  IS_DIRTY=1
-}
-
-## increment the number only of last found PART: REVISION --> PATCH --> MINOR. don't touch STAGE
-function increment_last_found(){
-  if [[ "${#PARTS[3]}" == 0 || "${PARTS[3]}" == "0" ]]; then
-    if [[ "${#PARTS[2]}" == 0 || "${PARTS[2]}" == "0" ]]; then
-      increment_minor
-    else
-      increment_patch
-    fi
-  else
-    increment_revision
-  fi
-
-  # stage part is not EMPTY
-  if [[ "${#PARTS[4]}" != 0 ]]; then
-    IS_SHIFT=1
-  fi
-}
-
-## compose version from PARTS
-function compose(){
-  MAJOR="${PARTS[0]}"
-  MINOR=".${PARTS[1]}"
-  PATCH=".${PARTS[2]}"
-  REVISION=".${PARTS[3]}"
-  SUFFIX="-${PARTS[4]}"
-
-  if [[ "${#PATCH}" == 1 ]]; then # if empty {PATCH}
-    PATCH=""
-  fi
-
-  if [[ "${#REVISION}" == 1 ]]; then # if empty {REVISION}
-    REVISION=""
-  fi
-
-  if [[ "${PARTS[3]}" == "0" ]]; then # if revision is ZERO
-    REVISION=""
-  fi
-
-  # shrink patch and revision
-  if [[ -z "${REVISION// }" ]]; then
-    if [[ "${PARTS[2]}" == "0" ]]; then
-      PATCH=".0"
-    fi
-  else # revision is not EMPTY
-    if [[ "${#PATCH}" == 0 ]]; then
-      PATCH=".0"
-    fi
-  fi
-
-  # remove suffix if we don't have a alpha/beta/rc
-  if [[ "${#SUFFIX}" == 1 ]]; then
-    SUFFIX=""
-  fi
-
-
-  echo "${MAJOR}${MINOR}${PATCH}${REVISION}${SUFFIX}" #full format
-}
-
-# initial version used for repository without tags
-INIT_VERSION=0.0.0.0-alpha
-
-# do GIT data extracting
-TAG=$(highest_tag)
-REVISION=$(latest_revision)
-BRANCH=$(current_branch)
-TAG_HASH=$(tag_hash $TAG)
-HEAD_HASH=$(head_hash)
-
-# if tag and branch commit hashes are different, than print info about that
-#echo $HEAD_HASH vs $TAG_HASH
-if [[ "$@" == "" ]]; then
-    if [[ "$TAG_HASH" == "$HEAD_HASH" ]]; then
-      echo "Tag $TAG and HEAD are aligned. We will stay on the TAG version."
-      echo ""
-      NO_ARGS_VALUE='--stay'
-    else
-      PATTERN="^[0-9]+.[0-9]+(.[0-9]+)*(-(alpha|beta|rc))*$"
-
-      if [[ "$BRANCH" =~ $PATTERN ]]; then
-        echo "Detected version branch '$BRANCH'. We will auto-increment the last version PART."
-        echo ""
-        NO_ARGS_VALUE='--default'
-      else
-        echo "Detected branch name '$BRANCH' than does not match version pattern. We will increase MINOR."
-        echo ""
-        NO_ARGS_VALUE='--minor'
-      fi
-    fi
-fi
-
-#
-# {MAJOR}.{MINOR}[.{PATCH}[.{REVISION}][-(.*)]
-#
-#  Suffix: alpha, beta, rc
-#    No Suffix --> {NEW_VERSION}-alpha
-#    alpha --> beta
-#    beta --> rc
-#    rc --> {VERSION}
-#
-PARTS=( ${TAG//./ } )
-parse_last ${#PARTS[@]} # array size as argument
-#echo ${PARTS[@]}
-
-# if no parameters than emulate --default parameter
-if [[ "$@" == "" ]]; then
-  set -- $NO_ARGS_VALUE
-fi
-
-# parse input parameters
-for i in "$@"
-do
-  key="$i"
-
-  case $key in
-    -a|--alpha)                 # switched to ALPHA
-    PARTS[4]="alpha"
-    IS_SHIFT=1
-    ;;
-    -b|--beta)                  # switched to BETA
-    PARTS[4]="beta"
-    IS_SHIFT=1
-    ;;
-    -c|--release-candidate)     # switched to RC
-    PARTS[4]="rc"
-    IS_SHIFT=1
-    ;;
-    -r|--release)               # switched to RELEASE
-    PARTS[4]=""
-    IS_SHIFT=1
-    ;;
-    -p|--patch)                 # increment of PATCH
-    increment_patch
-    ;;
-    -e|--revision)              # increment of REVISION
-    increment_revision
-    ;;
-    -g|--git-revision)          # use git revision number as a revision part§
-    PARTS[3]=$(( REVISION ))
-    IS_DIRTY=1
-    ;;
-    -i|--minor)                 # increment of MINOR by default
-    increment_minor
-    ;;
-    --default)                 # stay on the same stage, but increment only last found PART of version code
-    increment_last_found
-    ;;
-    -m|--major)                 # increment of MAJOR
-    incremet_major
-    ;;
-    -s|--stay)                  # extract version info
-    IS_DIRTY=1
-    NO_APPLY_MSG=1
-    ;;
-    -t|--tag-only)                  # extract version info
-    TAG_ONLY=1
-    ;;
-    --apply)
-    DO_APPLY=1
-    ;;
-    -h|--help)
-    help
-    ;;
-  esac
-  shift
-done
-
-# detected shift, but no increment
-if [[ "$IS_SHIFT" == "1" ]]; then
-    # temporary disable stage shift
-    stage=${PARTS[4]}
-    PARTS[4]=''
-
-    # detect first run on repository, INIT_VERSION was used
-    if [[ "$(compose)" == "0.0" ]]; then
-        increment_minor
-    fi
-
-    PARTS[4]=$stage
-fi
-
-# no increment applied yet and no shift of state, do minor increase
-if [[ "$IS_DIRTY$IS_SHIFT" == "" ]]; then
-    increment_minor
-fi
-
-compose
-
-# is proposed tag in conflict with any other TAG
-PROPOSED_HASH=$(tag_hash $(compose))
-if [[ "${#PROPOSED_HASH}" -gt 0 && "$NO_APPLY_MSG" == "" ]]; then
-  echo -e "\033[31mERROR:\033[0m "
-  echo -e "\033[31mERROR:\033[0m Found conflict with existing tag \033[32m$(compose)\033[0m / $PROPOSED_HASH"
-  echo -e "\033[31mERROR:\033[0m Only manual resolving is possible now."
-  echo -e "\033[31mERROR:\033[0m "
-  echo -e "\033[31mERROR:\033[0m To Resolve try to add --revision or --patch modifier."
-  echo -e "\033[31mERROR:\033[0m "
-  echo ""
-  exit 1
-fi

.gitignore

@@ -14,12 +14,15 @@ coverage
 stats
 *.log
 outlined
+lucide-font
 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/utils/*.ts
+!packages/shared/src/utils/*.ts
 packages/**/src/dynamicIconImports.ts
 packages/**/DynamicIcon.d.ts
 packages/**/dynamicIconImports.js
@@ -40,11 +43,13 @@ docs/.vitepress/.temp
 docs/.vitepress/data/iconNodes
 docs/.vitepress/data/iconMetaData.ts
 docs/.vitepress/data/releaseMetaData.json
-docs/.vitepress/data/releaseMetaData
+docs/.vitepress/data/releaseMetadata
 docs/.vitepress/data/categoriesData.json
 docs/.vitepress/data/iconDetails
 docs/.vitepress/data/relatedIcons.json
+docs/.vitepress/data/brandStopwords.json
 docs/.vercel
 docs/.nitro
+docs/public/og/**
+!docs/public/og/general.png
 .gitignore
-

.npmrc

@@ -1 +0,0 @@
-auto-install-peers=true

.vscode/settings.json

@@ -2,5 +2,5 @@
   "cSpell.words": ["devs", "preact", "Preact"],
   "eslint.enable": true,
   "eslint.validate": ["javascript", "svg"],
-  "svg.preview.background": "transparent"
+  "svg.preview.background": "editor"
 }

.vscode/svg.code-snippets

@@ -1,4 +1,5 @@
 {
+  "$schema": "https://raw.githubusercontent.com/Yash-Singh1/vscode-snippets-json-schema/main/schema.json",
   "Lucide SVG": {
     "scope": "xml",
     "description": "Base SVG with Lucide attributes.",
@@ -51,6 +52,16 @@
     ],
     "body": "<circle cx=\"${2:12}\" cy=\"${3:$2}\" r=\"${1|10,2,.5\" fill=\"currentColor|}\" />"
   },
+  "Squircle": {
+    "scope": "xml",
+    "description": "SVG `path` with Lucide defaults.",
+    "prefix": [
+      "squircle",
+      "path",
+      "<path"
+    ],
+    "body": "<path d=\"M12 3c7.2 0 9 1.8 9 9s-1.8 9-9 9-9-1.8-9-9 1.8-9 9-9\" />"
+  },
   "Ellipse": {
     "scope": "xml",
     "description": "SVG `ellipse`.",

BRAND_LOGOS_STATEMENT.md

@@ -0,0 +1,73 @@
+# Brand Logos Statement
+
+Our official stance on including brand logos in Lucide
+
+## TL;DR
+
+Lucide **does not accept** brand logos, and we do not plan to add them in the future.
+
+This is due to a combination of **legal restrictions**, **design consistency concerns**, and **practical maintenance reasons**.
+
+If you need brand logos, we recommend [Simple Icons](https://simpleicons.org/), which provides an extensive, legally safer collection of brand marks.
+
+---
+
+## 1. Historical Context
+
+This is not a new debate — other icon sets have gone through the same discussion:
+
+- **Material Design Icons** [deprecated all brand icons](https://github.com/Templarian/MaterialDesign/issues/6602) because they didn't fit the style, didn't work well in one color, and often looked out of place in a 24×24px grid.
+- **Feather Icons** [came to the same conclusion](https://github.com/feathericons/feather/issues/763): brand logos have their own style, and forcing them into another inevitably leads to aesthetic compromises.
+- **Lucide** learned from these examples — we'd rather focus on making a consistent set of non-brand icons that all work together.
+
+## 2. Legal Considerations
+
+Most brand logos:
+- Are **protected by trademark or copyright**.
+- Have **strict rules** for how they can be used (colors, spacing, proportions, etc.).
+- **Don't allow modification** — but we'd have to change them to fit Lucide's style.
+
+This means adding them could:
+1. Break copyright or trademark law.
+2. Make both you and the Lucide project legally responsible.
+3. Force us to review every new request one by one for legal issues — something we simply can't do.
+
+> **Note:** Simple Icons avoids this by keeping logos exactly as the brand provides them — though even they sometimes face [legal challenges](https://github.com/simple-icons/simple-icons/issues/11236).
+
+## 3. Design & Consistency
+
+Lucide is all about **visual consistency**.
+
+Adding brand logos would:
+- Break [our own design rules](https://lucide.dev/guide/design/icon-design-guide#icon-design-principles) for shapes, proportions, and stroke.
+- Mix two fundamentally different categories of graphics (pictograms vs. corporate logos).
+- Create a library where a subset of icons will always look "out of place".
+
+If the logos are not in Lucide's style, why include them in Lucide at all? Better to use them from a dedicated brand icon source.
+
+## 4. Maintenance Burden
+
+Even with our current **"no brand icon requests"** policy, people still request them regularly.
+
+Having any brand icons in the set:
+- Makes people think we might add more in the future.
+- Leads to repeated requests and the same conversations over and over.
+- Wastes maintainer time redirecting people to the same explanation.
+
+Removing them entirely solves this problem.
+
+## 5. Recommended Alternatives
+
+If you need brand icons, try:
+- [Simple Icons](https://simpleicons.org/): offers a huge range of brands, in consistent SVG format, using a 24×24 viewBox, the same as ours.
+- Official brand asset pages: most major companies provide downloadable SVGs.
+
+You can use these alongside Lucide without bloating our core library.
+
+## Final Words
+
+Lucide is an **icon** set, not a **logo** set.
+
+Logos belong in dedicated logo resources.
+
+We're focusing on what Lucide does best: providing a clean, cohesive, and legally safe collection of open-source icons.

CODE_OF_CONDUCT.md

@@ -1,74 +1,90 @@
 # Contributor Covenant Code of Conduct
 
+This Code of Conduct outlines our expectations for participant behavior as well as the consequences for unacceptable behavior within our community. We are committed to providing a welcoming, safe, and inclusive environment for all members of our community.
+
 ## Our Pledge
 
-In the interest of fostering an open and welcoming environment, we as
-contributors and maintainers pledge to making participation in our project and
-our community a harassment-free experience for everyone, regardless of age, body
-size, disability, ethnicity, gender identity and expression, level of experience,
-nationality, personal appearance, race, religion, or sexual identity and
-orientation.
+We pledge to make our community welcoming, safe, and equitable for all.
 
-## Our Standards
+We are committed to fostering an environment that respects and promotes the dignity, rights, and contributions of all individuals, regardless of characteristics including race, ethnicity, caste, color, age, physical characteristics, neurodiversity, disability, sex or gender, gender identity or expression, sexual orientation, language, philosophy or religion, national or social origin, socio-economic position, level of education, or other status. The same privileges of participation are extended to everyone who participates in good faith and in accordance with this Covenant.
 
-Examples of behavior that contributes to creating a positive environment
-include:
+## Encouraged Behaviors
 
-* Using welcoming and inclusive language
-* Being respectful of differing viewpoints and experiences
-* Gracefully accepting constructive criticism
-* Focusing on what is best for the community
-* Showing empathy towards other community members
+While acknowledging differences in social norms, we all strive to meet our community's expectations for positive behavior. We also understand that our words and actions may be interpreted differently than we intend based on culture, background, or native language.
 
-Examples of unacceptable behavior by participants include:
+With these considerations in mind, we agree to behave mindfully toward each other and act in ways that center our shared values, including:
 
-* The use of sexualized language or imagery and unwelcome sexual attention or
-advances
-* Trolling, insulting/derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or electronic
-  address, without explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
-  professional setting
+1. Respecting the **purpose of our community**, our activities, and our ways of gathering.
+2. Engaging **kindly and honestly** with others.
+3. Respecting **different viewpoints** and experiences.
+4. **Taking responsibility** for our actions and contributions.
+5. Gracefully giving and accepting **constructive feedback**.
+6. Committing to **repairing harm** when it occurs.
+7. Behaving in other ways that promote and sustain the **well-being of our community**.
 
-## Our Responsibilities
 
-Project maintainers are responsible for clarifying the standards of acceptable
-behavior and are expected to take appropriate and fair corrective action in
-response to any instances of unacceptable behavior.
+## Restricted Behaviors
+
+We agree to restrict the following behaviors in our community. Instances, threats, and promotion of these behaviors are violations of this Code of Conduct.
+
+1. **Harassment.** Violating explicitly expressed boundaries or engaging in unnecessary personal attention after any clear request to stop.
+2. **Character attacks.** Making insulting, demeaning, or pejorative comments directed at a community member or group of people.
+3. **Stereotyping or discrimination.** Characterizing anyone’s personality or behavior on the basis of immutable identities or traits.
+4. **Sexualization.** Behaving in a way that would generally be considered inappropriately intimate in the context or purpose of the community.
+5. **Violating confidentiality**. Sharing or acting on someone's personal or private information without their permission.
+6. **Endangerment.** Causing, encouraging, or threatening violence or other harm toward any person or group.
+7. Behaving in other ways that **threaten the well-being** of our community.
+
+### Other Restrictions
+
+1. **Misleading identity.** Impersonating someone else for any reason, or pretending to be someone else to evade enforcement actions.
+2. **Failing to credit sources.** Not properly crediting the sources of content you contribute.
+3. **Promotional materials**. Sharing marketing or other commercial content in a way that is outside the norms of the community.
+4. **Irresponsible communication.** Failing to responsibly present content which includes, links or describes any other restricted behaviors.
+
+
+## Reporting an Issue
+
+Tensions can occur between community members even when they are trying their best to collaborate. Not every conflict represents a code of conduct violation, and this Code of Conduct reinforces encouraged behaviors and norms that can help avoid conflicts and minimize harm.
+
+When an incident does occur, it is important to report it promptly. To report a possible violation, email: [info@lucide.dev](mailto:info@lucide.dev)
+
+Community Moderators take reports of violations seriously and will make every effort to respond in a timely manner. They will investigate all reports of code of conduct violations, reviewing messages, logs, and recordings, or interviewing witnesses and other participants. Community Moderators will keep investigation and enforcement actions as transparent as possible while prioritizing safety and confidentiality. In order to honor these values, enforcement actions are carried out in private with the involved parties, but communicating to the whole community may be part of a mutually agreed upon resolution.
+
+
+## Addressing and Repairing Harm
+
+If an investigation by the Community Moderators finds that this Code of Conduct has been violated, the following enforcement ladder may be used to determine how best to repair harm, based on the incident's impact on the individuals involved and the community as a whole. Depending on the severity of a violation, lower rungs on the ladder may be skipped.
+
+1) Warning
+   1) Event: A violation involving a single incident or series of incidents.
+   2) Consequence: A private, written warning from the Community Moderators.
+   3) Repair: Examples of repair include a private written apology, acknowledgement of responsibility, and seeking clarification on expectations.
+2) Temporarily Limited Activities
+   1) Event: A repeated incidence of a violation that previously resulted in a warning, or the first incidence of a more serious violation.
+   2) Consequence: A private, written warning with a time-limited cooldown period designed to underscore the seriousness of the situation and give the community members involved time to process the incident. The cooldown period may be limited to particular communication channels or interactions with particular community members.
+   3) Repair: Examples of repair may include making an apology, using the cooldown period to reflect on actions and impact, and being thoughtful about re-entering community spaces after the period is over.
+3) Temporary Suspension
+   1) Event: A pattern of repeated violation which the Community Moderators have tried to address with warnings, or a single serious violation.
+   2) Consequence: A private written warning with conditions for return from suspension. In general, temporary suspensions give the person being suspended time to reflect upon their behavior and possible corrective actions.
+   3) Repair: Examples of repair include respecting the spirit of the suspension, meeting the specified conditions for return, and being thoughtful about how to reintegrate with the community when the suspension is lifted.
+4) Permanent Ban
+   1) Event: A pattern of repeated code of conduct violations that other steps on the ladder have failed to resolve, or a violation so serious that the Community Moderators determine there is no way to keep the community safe with this person as a member.
+   2) Consequence: Access to all community spaces, tools, and communication channels is removed. In general, permanent bans should be rarely used, should have strong reasoning behind them, and should only be resorted to if working through other remedies has failed to change the behavior.
+   3) Repair: There is no possible repair in cases of this severity.
+
+This enforcement ladder is intended as a guideline. It does not limit the ability of Community Managers to use their discretion and judgment, in keeping with the best interests of our community.
 
-Project maintainers have the right and responsibility to remove, edit, or
-reject comments, commits, code, wiki edits, issues, and other contributions
-that are not aligned to this Code of Conduct, or to ban temporarily or
-permanently any contributor for other behaviors that they deem inappropriate,
-threatening, offensive, or harmful.
 
 ## Scope
 
-This Code of Conduct applies both within project spaces and in public spaces
-when an individual is representing the project or its community. Examples of
-representing a project or community include using an official project e-mail
-address, posting via an official social media account, or acting as an appointed
-representative at an online or offline event. Representation of a project may be
-further defined and clarified by project maintainers.
+This Code of Conduct applies within all community spaces, and also applies when an individual is officially representing the community in public or other spaces. Examples of representing our community include using an official email address, posting via an official social media account, or acting as an appointed representative at an online or offline event.
 
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at johnletey@gmail.com. All
-complaints will be reviewed and investigated and will result in a response that
-is deemed necessary and appropriate to the circumstances. The project team is
-obligated to maintain confidentiality with regard to the reporter of an incident.
-Further details of specific enforcement policies may be posted separately.
-
-Project maintainers who do not follow or enforce the Code of Conduct in good
-faith may face temporary or permanent repercussions as determined by other
-members of the project's leadership.
 
 ## Attribution
 
-This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
-available at [http://contributor-covenant.org/version/1/4][version]
+This Code of Conduct is adapted from the Contributor Covenant, version 3.0, permanently available at [https://www.contributor-covenant.org/version/3/0/](https://www.contributor-covenant.org/version/3/0/).
 
-[homepage]: http://contributor-covenant.org
-[version]: http://contributor-covenant.org/version/1/4/
+Contributor Covenant is stewarded by the Organization for Ethical Source and licensed under CC BY-SA 4.0. To view a copy of this license, visit [https://creativecommons.org/licenses/by-sa/4.0/](https://creativecommons.org/licenses/by-sa/4.0/)
+
+For answers to common questions about Contributor Covenant, see the FAQ at [https://www.contributor-covenant.org/faq](https://www.contributor-covenant.org/faq). Translations are provided at [https://www.contributor-covenant.org/translations](https://www.contributor-covenant.org/translations). Additional enforcement and community guideline resources can be found at [https://www.contributor-covenant.org/resources](https://www.contributor-covenant.org/resources). The enforcement ladder was inspired by the work of [Mozilla’s code of conduct team](https://github.com/mozilla/inclusion).

CONTRIBUTING.md

@@ -1,5 +1,4 @@
-
-# Contribution Guidelines
+# Contribution Guide
 
 :+1::tada: First off, thanks for taking the time to contribute! :tada::+1:
 
@@ -19,13 +18,15 @@ Guidelines for pull requests:
 - __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 commits, it won't be accepted.
 
-### Icon Pull Requests
+### Contributing Icons
+
+We love contributions of new icons from the community! If you want to contribute new icons, please follow the guidelines below.
 
 #### Guidelines
 
 Please make sure you follow the icon guidelines, that should be followed to keep quality and consistency when making icons for Lucide.
 
-Read it here: [ICON_GUIDELINES](https://lucide.dev/docs/icon-design-guide).
+Read it here: [ICON_GUIDELINES](https://lucide.dev/contribute/icon-design-guide).
 
 #### Lucide Studio
 
@@ -35,15 +36,15 @@ For formatting and adjusting SVG icons, [@jguddas](https://github.com/jguddas) m
 
 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/contribute/illustrator-guide)
 
-You can also [download an Adobe Illustrator template](https://github.com/lucide-icons/lucide/blob/main/docs/public/templates/illustrator_template.ai).
+You can also [download an Adobe Illustrator template](https://lucide.dev/templates/illustrator_template.ai).
 
-##### [Inkscape Guide](https://lucide.dev/docs/inkscape-guide)
+##### [Inkscape Guide](https://lucide.dev/contribute/inkscape-guide)
 
-##### [Figma Guide](https://lucide.dev/docs/figma-guide)
+##### [Figma Guide](https://lucide.dev/contribute/figma-guide)
 
-##### [Affinity Designer Guide](https://lucide.dev/guide/design/affinity-designer-guide)
+##### [Affinity Designer Guide](https://lucide.dev/contribute/affinity-designer-guide)
 
 #### Submitting Multiple Icons
 
@@ -191,7 +192,7 @@ Detailed documentation about: installation, guides, packages, design guides etc.
 
 ### Icons
 
-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.
+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
 

LICENSE

@@ -1,6 +1,6 @@
 ISC License
 
-Copyright (c) for portions of Lucide are held by Cole Bemis 2013-2022 as part of Feather (MIT). All other copyright (c) for Lucide are held by Lucide Contributors 2022.
+Copyright (c) 2026 Lucide Icons and Contributors
 
 Permission to use, copy, modify, and/or distribute this software for any
 purpose with or without fee is hereby granted, provided that the above
@@ -13,3 +13,31 @@ ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+---
+
+The following Lucide icons are derived from the Feather project:
+
+airplay, alert-circle, alert-octagon, alert-triangle, aperture, arrow-down-circle, arrow-down-left, arrow-down-right, arrow-down, arrow-left-circle, arrow-left, arrow-right-circle, arrow-right, arrow-up-circle, arrow-up-left, arrow-up-right, arrow-up, at-sign, calendar, cast, check, chevron-down, chevron-left, chevron-right, chevron-up, chevrons-down, chevrons-left, chevrons-right, chevrons-up, circle, clipboard, clock, code, columns, command, compass, corner-down-left, corner-down-right, corner-left-down, corner-left-up, corner-right-down, corner-right-up, corner-up-left, corner-up-right, crosshair, database, divide-circle, divide-square, dollar-sign, download, external-link, feather, frown, hash, headphones, help-circle, info, italic, key, layout, life-buoy, link-2, link, loader, lock, log-in, log-out, maximize, meh, minimize, minimize-2, minus-circle, minus-square, minus, monitor, moon, more-horizontal, more-vertical, move, music, navigation-2, navigation, octagon, pause-circle, percent, plus-circle, plus-square, plus, power, radio, rss, search, server, share, shopping-bag, sidebar, smartphone, smile, square, table-2, tablet, target, terminal, trash-2, trash, triangle, tv, type, upload, x-circle, x-octagon, x-square, x, zoom-in, zoom-out
+
+The MIT License (MIT) (for the icons listed above)
+
+Copyright (c) 2013-present Cole Bemis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -45,7 +45,7 @@ Lucide is an open-source icon library that provides 1000+ vector (svg) files for
 
 ### Figma
 
-The lucide figma plugin.
+The Lucide Figma plugin.
 
 Visit [Figma community page](https://www.figma.com/community/plugin/939567362549682242/Lucide-Icons) to install the plugin.
 
@@ -57,6 +57,12 @@ For more info on how to contribute please see the [contribution guidelines](http
 
 Caught a mistake or want to contribute to the documentation? [Edit this page on Github](https://github.com/lucide-icons/lucide/blob/main/README.md)
 
+## About brand logos
+
+Lucide **does not accept** brand logos, and we do not plan to add them in the future. This is due to a combination of **legal restrictions**, **design consistency concerns**, and **practical maintenance reasons**.
+
+[Click here to read our official statement about brand logos in Lucide.](./BRAND_LOGOS_STATEMENT.md)
+
 ## Community
 
 Join the community on our [Discord](https://discord.gg/EH6nSts) server!
@@ -82,7 +88,16 @@ 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>
 
+[//]: <> (Open Collective backers)
 ### 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>
+<a href="https://github.com/pdfme/pdfme"><img src="docs/public/sponsors/pdfme.svg" width="180" alt="pdfme – Open-source PDF generation library built with TypeScript and React." /></a>
+<a href="https://www.paxhistoria.co/"><img src="docs/public/sponsors/paxhistoria.svg?" width="180" alt="Pax Historia – An alternate history sandbox game" /></a>
+
+### Backers ☕
+
+<a href="https://www.fina.money/"><img src="docs/public/sponsors/fina-money.png" width="180" alt="Fina Money – Modular Finance Tracker" /></a>
+
+### Other contributors 💸
+
+You can find all our past and non-recurring financial contributors at [our Open Collective page](https://opencollective.com/lucide-icons).

brand-stopwords.json

@@ -0,0 +1,150 @@
+{
+  "adobe": "Adobe",
+  "airplay": "AirPlay",
+  "amazon": "Amazon",
+  "android": "Android",
+  "angular": "Angular",
+  "aws": "AWS",
+  "azure": "Azure",
+  "bandcamp": "Bandcamp",
+  "behance": "Behance",
+  "bitbucket": "Bitbucket",
+  "blender": "Blender",
+  "bluesky": "BlueSky",
+  "bootstrap": "Bootstrap",
+  "brave": "Brave",
+  "chakra": "Chakra UI",
+  "chrome": "Chrome",
+  "codepen": "Codepen",
+  "codesandbox": "CodeSandbox",
+  "csharp": "C#",
+  "cypress": "Cypress",
+  "dart": "Dart",
+  "deezer": "Deezer",
+  "deno": "Deno",
+  "discord": "Discord",
+  "docker": "Docker",
+  "dribbble": "Dribbble",
+  "dropbox": "Dropbox",
+  "edge": "Edge",
+  "ember": "Ember",
+  "epic": "Epic Games",
+  "erlang": "Erlang",
+  "esbuild": "esbuild",
+  "eslint": "ESLint",
+  "facebook": "Facebook",
+  "figjam": "FigJam",
+  "figma": "Figma",
+  "firebase": "Firebase",
+  "firefox": "Firefox",
+  "framer": "Framer",
+  "gatsby": "Gatsby",
+  "gcp": "Google Cloud",
+  "github": "GitHub",
+  "gitlab": "GitLab",
+  "golang": "GoLang",
+  "google": "Google",
+  "gmail": "Gmail",
+  "gravatar": "Gravatar",
+  "haskell": "Haskell",
+  "instagram": "Instagram",
+  "java": "Java",
+  "javascript": "JavaScript",
+  "jest": "Jest",
+  "jira": "Jira",
+  "kotlin": "Kotlin",
+  "kubernetes": "Kubernetes",
+  "less": "Less",
+  "leetcode": "LeetCode",
+  "leet-code": "LeetCode",
+  "line": "LINE",
+  "linkedin": "LinkedIn",
+  "lua": "Lua",
+  "mariadb": "MariaDB",
+  "mcp": "MCP",
+  "messenger": "Messenger",
+  "microsoft": "Microsoft",
+  "mongodb": "MongoDB",
+  "mui": "Material UI",
+  "mysql": "MySQL",
+  "nestjs": "NestJS",
+  "netflix": "Netflix",
+  "netlify": "Netlify",
+  "next": "Next.js",
+  "nodejs": "Node.js",
+  "notion": "Notion",
+  "nostr": "Nostr",
+  "npm": "npm",
+  "nuxt": "Nuxt",
+  "opera": "Opera",
+  "oracle": "Oracle",
+  "patreon": "Patreon",
+  "paypal": "PayPal",
+  "perl": "Perl",
+  "php": "PHP",
+  "pinterest": "Pinterest",
+  "pix": "PiX",
+  "playstation": "PlayStation",
+  "playwright": "Playwright",
+  "pnpm": "pnpm",
+  "postcss": "PostCSS",
+  "postgresql": "PostgreSQL",
+  "prettier": "Prettier",
+  "prisma": "Prisma",
+  "python": "Python",
+  "qwik": "Qwik",
+  "react": "React",
+  "reddit": "Reddit",
+  "redis": "Redis",
+  "rollup": "Rollup",
+  "rust": "Rust",
+  "safari": "Safari",
+  "sass": "Sass",
+  "scala": "Scala",
+  "scss": "Sass",
+  "semantic": "Semantic UI",
+  "shopify": "Shopify",
+  "skype": "Skype",
+  "slack": "Slack",
+  "solid": "SolidJS",
+  "soundcloud": "SoundCloud",
+  "spotify": "Spotify",
+  "sqlite": "SQLite",
+  "squarespace": "Squarespace",
+  "steam": "Steam",
+  "stripe": "Stripe",
+  "substack": "Substack",
+  "supabase": "Supabase",
+  "surge": "Surge",
+  "svelte": "Svelte",
+  "swift": "Swift",
+  "tailwind": "Tailwind CSS",
+  "telegram": "Telegram",
+  "terraform": "Terraform",
+  "tesla": "Tesla",
+  "tidal": "Tidal",
+  "tiktok": "TikTok",
+  "trello": "Trello",
+  "twitch": "Twitch",
+  "twitter": "Twitter",
+  "typescript": "TypeScript",
+  "unity": "Unity",
+  "unreal": "Unreal Engine",
+  "vercel": "Vercel",
+  "vimeo": "Vimeo",
+  "vite": "Vite",
+  "vitest": "Vitest",
+  "vue": "Vue",
+  "webpack": "Webpack",
+  "wechat": "WeChat",
+  "whatsapp": "WhatsApp",
+  "windows": "Windows",
+  "wix": "Wix",
+  "x.com": "X.com",
+  "x-social": "X.com",
+  "xbox": "Xbox",
+  "yarn": "Yarn",
+  "youtube": "YouTube",
+  "zig": "Zig",
+  "zoom": "Zoom"
+}

categories/brands.json

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

categories/navigation.json

@@ -1,5 +1,5 @@
 {
   "$schema": "../category.schema.json",
-  "title": "Navigation",
+  "title": "Navigation, Maps, and POIs",
   "icon": "compass"
 }

docs/.vitepress/api/categories/index.get.ts

@@ -1,3 +1,4 @@
+import { eventHandler, setResponseHeader } from 'h3';
 import iconMetaData from '../../data/iconMetaData';
 
 export default eventHandler((event) => {

docs/.vitepress/api/figma/data.ts

@@ -1,3 +1,4 @@
+import { eventHandler, setResponseHeader } from 'h3';
 import iconNodes from '../../data/iconNodes/index.ts';
 import { IconNodeWithKeys } from '../../theme/types';
 import iconMetaData from '../../data/iconMetaData';

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

@@ -1,6 +1,6 @@
 import { eventHandler, setResponseHeader, defaultContentType } from 'h3';
 import { renderToString, renderToStaticMarkup } from 'react-dom/server';
-import { createElement } from 'react';
+import React from 'react';
 import SvgPreview from '../../lib/SvgPreview/index.tsx';
 import iconNodes from '../../data/iconNodes';
 import createLucideIcon from 'lucide-react/src/createLucideIcon';
@@ -15,8 +15,10 @@ export default eventHandler((event) => {
 
   const src = Buffer.from(data, 'base64').toString('utf8').replaceAll('\n', '');
 
-  const width = parseInt((src.includes('svg') ? src.match(/width="(\d+)"/)?.[1] : null) ?? '24');
-  const height = parseInt((src.includes('svg') ? src.match(/height="(\d+)"/)?.[1] : null) ?? '24');
+  const width = parseInt((src.includes('<svg ') ? src.match(/width="(\d+)"/)?.[1] : null) ?? '24');
+  const height = parseInt(
+    (src.includes('<svg ') ? src.match(/height="(\d+)"/)?.[1] : null) ?? '24',
+  );
 
   const children = [];
 
@@ -32,36 +34,29 @@ export default eventHandler((event) => {
     const iconNode = iconNodes[backdropName];
 
     const LucideIcon = createLucideIcon(backdropName, iconNode);
-    const svg = renderToStaticMarkup(createElement(LucideIcon));
+    const svg = renderToStaticMarkup(<LucideIcon />);
     const backdropString = svg.replaceAll('\n', '').replace(/<svg[^>]*>|<\/svg>/g, '');
 
     children.push(
-      createElement(Backdrop, {
-        backdropString,
-        src: src.replace(/<svg[^>]*>|<\/svg>/g, ''),
-        color: '#777',
-      }),
+      <Backdrop
+        backdropString={backdropString}
+        src={src.replace(/<svg[^>]*>|<\/svg>/g, '')}
+        color="#777"
+      />,
     );
   }
 
-  const svg = Buffer.from(
-    // We can't use jsx here, is not supported here by nitro.
-    renderToString(
-      createElement(
-        SvgPreview,
-        {
-          src: src.replace(/<svg[^>]*>|<\/svg>/g, ''),
-          height,
-          width,
-          showGrid: true,
-        },
-        children,
-      ),
-    ),
-  ).toString('utf8');
-
   defaultContentType(event, 'image/svg+xml');
   setResponseHeader(event, 'Cache-Control', 'public,max-age=31536000');
 
-  return svg;
+  return renderToString(
+    <SvgPreview
+      src={src.replace(/<svg[^>]*>|<\/svg>/g, '')}
+      showGrid
+      height={height}
+      width={width}
+    >
+      {children}
+    </SvgPreview>,
+  );
 });

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

@@ -1,6 +1,6 @@
 import { eventHandler, setResponseHeader, defaultContentType } from 'h3';
 import { renderToString, renderToStaticMarkup } from 'react-dom/server';
-import { createElement } from 'react';
+import React from 'react';
 import Diff from '../../../lib/SvgPreview/Diff.tsx';
 import iconNodes from '../../../data/iconNodes';
 import createLucideIcon from 'lucide-react/src/createLucideIcon';
@@ -17,21 +17,35 @@ export default eventHandler((event) => {
     .replaceAll('\n', '')
     .replace(/<svg[^>]*>|<\/svg>/g, '');
 
+  const width = parseInt(
+    (newSrc.includes('<svg ') ? newSrc.match(/width="(\d+)"/)?.[1] : null) ?? '24',
+  );
+  const height = parseInt(
+    (newSrc.includes('<svg ') ? newSrc.match(/height="(\d+)"/)?.[1] : null) ?? '24',
+  );
+
   const children = [];
 
+  const Icon = createLucideIcon(name, iconNodes[name]);
+
   const oldSrc = iconNodes[name]
-    ? renderToStaticMarkup(createElement(createLucideIcon(name, iconNodes[name])))
+    ? renderToStaticMarkup(<Icon />)
         .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;
+  return renderToString(
+    <Diff
+      oldSrc={oldSrc}
+      newSrc={newSrc}
+      showGrid
+      height={height}
+      width={width}
+    >
+      {children}
+    </Diff>,
+  );
 });

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

@@ -1,45 +1,52 @@
 import { eventHandler, setResponseHeader, defaultContentType } from 'h3';
-import { Resvg, initWasm } from '@resvg/resvg-wasm';
-import wasm from './loadWasm';
-
-var initializedResvg = initWasm(wasm);
+import iconNodes from '../../../data/iconNodes';
+import { createElement } from 'react';
+import { renderToStaticMarkup } from 'react-dom/server';
+import createLucideIcon from 'lucide-react/src/createLucideIcon';
+import sharp from 'sharp';
 
 export default eventHandler(async (event) => {
   const { params = {} } = event.context;
-  await initializedResvg;
-
   const imageSize = 96;
-  const [iconSizeString, svgData] = params.data.split('/');
+  const name = params.data.split('/').at(-3);
+  const iconSizeString = params.data.split('/').at(-2);
+  const svgData = params.data.split('/').at(-1);
   const iconSize = parseInt(iconSizeString, 10);
   const data = svgData.slice(0, -4);
 
+  const prevSvg = iconNodes[name]
+    ? renderToStaticMarkup(createElement(createLucideIcon(name, iconNodes[name])))
+    : undefined;
+
   const src = Buffer.from(data, 'base64').toString('utf8');
   const svg = (src.includes('<svg') ? src : `<svg>${src}</svg>`)
     .replace(/(\r\n|\n|\r)/gm, '')
     .replace(
-      /<svg[^>]*/,
+      /<svg[^>]*>/,
       `<svg
   xmlns="http://www.w3.org/2000/svg"
   width="${iconSize}"
-  height="${iconSize}"
-  viewBox="0 0 24 24"
+  height="${prevSvg ? iconSize * 2 : iconSize}"
+  viewBox="0 0 24 ${prevSvg ? 48 : 24}"
   fill="none"
   stroke="#fff"
   stroke-width="2"
   stroke-linecap="round"
   stroke-linejoin="round"
+  >
+  ${prevSvg?.replaceAll('\n', '').replace(/<svg[^>]*>|<\/svg>/g, '')}
+  <g transform="translate(0, ${prevSvg ? 24 : 0})">
 `,
-    );
+    )
+    .replace(/<\/svg>/, '</g></svg>');
 
-  const resvg = new Resvg(svg, { background: '#000' });
-  const pngData = resvg.render();
-  const pngBuffer = Buffer.from(pngData.asPng());
+  const pngBuffer = await sharp(Buffer.from(svg)).png().toBuffer();
 
   defaultContentType(event, 'image/svg+xml');
   setResponseHeader(event, 'Cache-Control', 'public,max-age=31536000');
 
   return `
-<svg xmlns="http://www.w3.org/2000/svg" width="${imageSize}" height="${imageSize}" viewBox="0 0 ${imageSize} ${imageSize}">
+<svg xmlns="http://www.w3.org/2000/svg" width="${imageSize}" height="${prevSvg ? imageSize * 2 : imageSize}" viewBox="0 0 ${imageSize} ${prevSvg ? imageSize * 2 : imageSize}">
   <style>
     @media screen and (prefers-color-scheme: light) {
       #fallback-background { fill: transparent; }
@@ -52,20 +59,20 @@ export default eventHandler(async (event) => {
   <mask id="mask">
     <image
       width="${imageSize}"
-      height="${imageSize}"
-      href="data:image/png;base64,${pngBuffer.toString('base64')}"
+      height="${prevSvg ? imageSize * 2 : imageSize}"
+       href="data:image/png;base64,${pngBuffer.toString('base64')}"
       image-rendering="pixelated"
     />
   </mask>
   <rect
     id="fallback-background"
-    width="${imageSize}"
-    height="${imageSize}" ry="${imageSize / 24}"
+    width="100%"
+    height="100%" ry="${imageSize / 24}"
     fill="#fff"
   />
   <rect
-    width="${imageSize}"
-    height="${imageSize}"
+    width="100%"
+    height="100%"
     fill="#000"
     mask="url(#mask)"
   />

docs/.vitepress/api/gh-icon/dpi/loadWasm.ts

@@ -1,15 +0,0 @@
-import fs from 'fs';
-import module from 'node:module';
-/* WASM_IMPORT */
-
-let wasm;
-
-if (process.env.NODE_ENV === 'development') {
-  const require = module.createRequire(import.meta.url);
-
-  wasm = fs.readFileSync(require.resolve('@resvg/resvg-wasm/index_bg.wasm'));
-} else {
-  wasm = resvg_wasm;
-}
-
-export default wasm;

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

@@ -1,44 +0,0 @@
-import { eventHandler, setResponseHeader, defaultContentType } from 'h3';
-import { renderToString } from 'react-dom/server';
-import { createElement } from 'react';
-import SvgPreview from '../../../lib/SvgPreview/index.tsx';
-import createLucideIcon, { IconNode } from 'lucide-react/src/createLucideIcon';
-import { parseSync } from 'svgson';
-
-export default eventHandler((event) => {
-  const { params } = event.context;
-
-  const [strokeWidth, svgData] = params.data.split('/');
-  const data = svgData.slice(0, -4);
-
-  const src = Buffer.from(data, 'base64').toString('utf8');
-
-  const Icon = createLucideIcon(
-    'icon',
-    parseSync(src.includes('<svg') ? src : `<svg>${src}</svg>`).children.map(
-      ({ name, attributes }) => [name, attributes],
-    ) as IconNode,
-  );
-
-  const svg = Buffer.from(
-    // We can't use jsx here, is not supported here by nitro.
-    renderToString(createElement(Icon, { strokeWidth }))
-      .replace(/fill\="none"/, 'fill="#fff"')
-      .replace(
-        />/,
-        `><style>
-        @media screen and (prefers-color-scheme: light) {
-          svg { fill: transparent !important; }
-        }
-        @media screen and (prefers-color-scheme: dark) {
-          svg { stroke: #fff; fill: transparent !important; }
-        }
-      </style>`,
-      ),
-  ).toString('utf8');
-
-  defaultContentType(event, 'image/svg+xml');
-  setResponseHeader(event, 'Cache-Control', 'public,max-age=31536000');
-
-  return svg;
-});

docs/.vitepress/api/gh-icon/stroke-width/[...data].get.tsx

@@ -0,0 +1,37 @@
+import { eventHandler, setResponseHeader, defaultContentType } from 'h3';
+import { renderToString } from 'react-dom/server';
+import React from 'react';
+import Icon from 'lucide-react/src/Icon';
+import type { IconNode } from 'lucide-react/src/types';
+import { parseSync } from 'svgson';
+
+export default eventHandler((event) => {
+  const { params } = event.context;
+
+  const [strokeWidth, svgData] = params.data.split('/');
+  const data = svgData.slice(0, -4);
+
+  const src = Buffer.from(data, 'base64').toString('utf8');
+  const iconNode = parseSync(src.includes('<svg') ? src : `<svg>${src}</svg>`).children.map(
+    ({ name, attributes }) => [name, attributes],
+  ) as IconNode;
+
+  defaultContentType(event, 'image/svg+xml');
+  setResponseHeader(event, 'Cache-Control', 'public,max-age=31536000');
+
+  return renderToString(
+    <Icon
+      iconNode={iconNode}
+      strokeWidth={strokeWidth}
+    >
+      <style>
+        {`@media screen and (prefers-color-scheme: light) {
+          svg { fill: transparent !important; }
+        }
+        @media screen and (prefers-color-scheme: dark) {
+          svg { stroke: #fff; fill: transparent !important; }
+        }`}
+      </style>
+    </Icon>,
+  );
+});

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

@@ -0,0 +1,58 @@
+import { eventHandler, setResponseHeader, defaultContentType } from 'h3';
+import { renderToString } from 'react-dom/server';
+import React from 'react';
+import Diff from '../../../lib/SvgPreview/Diff.tsx';
+
+export default eventHandler((event) => {
+  const { params } = event.context;
+
+  const pathData = params.data.split('/');
+  const data = pathData.at(-1).slice(0, -4);
+  const [operation] = pathData;
+
+  const newSrc = Buffer.from(data, 'base64')
+    .toString('utf8')
+    .replaceAll('\n', '')
+    .replace(/<svg[^>]*>|<\/svg>/g, '');
+
+  const width = parseInt(
+    (newSrc.includes('<svg ') ? newSrc.match(/width="(\d+)"/)?.[1] : null) ?? '24',
+  );
+  const height = parseInt(
+    (newSrc.includes('<svg ') ? newSrc.match(/height="(\d+)"/)?.[1] : null) ?? '24',
+  );
+
+  const children = [];
+
+  let oldSrc = '';
+  if (operation.startsWith('rotate-')) {
+    const degrees = parseInt(operation.replace('rotate-', ''));
+    if (isNaN(degrees)) return '';
+    oldSrc = `<g transform="rotate(${degrees} ${width / 2} ${height / 2})">${newSrc}</g>`;
+  } else if (operation === 'flip-horizontal') {
+    oldSrc = `<g transform="scale(1, -1) translate(0, -${height})">${newSrc}</g>`;
+  } else if (operation === 'flip-vertical') {
+    oldSrc = `<g transform="scale(-1, 1) translate(-${width}, 0)">${newSrc}</g>`;
+  } else if (operation === 'flip-backslash') {
+    oldSrc = `<g transform="rotate(90, ${width / 2}, ${height / 2}) scale(1, -1) translate(0, -${height})">${newSrc}</g>`;
+  } else if (operation === 'flip-slash') {
+    oldSrc = `<g transform="rotate(90, ${width / 2}, ${height / 2}) scale(-1, 1) translate(-${width}, 0)">${newSrc}</g>`;
+  } else {
+    return '';
+  }
+
+  defaultContentType(event, 'image/svg+xml');
+  setResponseHeader(event, 'Cache-Control', 'public,max-age=31536000');
+
+  return renderToString(
+    <Diff
+      oldSrc={oldSrc}
+      newSrc={newSrc}
+      showGrid
+      height={height}
+      width={width}
+    >
+      {children}
+    </Diff>,
+  );
+});

docs/.vitepress/api/icons/[iconName].get.ts

@@ -22,6 +22,7 @@ export default eventHandler((event) => {
   const height = getQuery(event).height || undefined;
   const color = getQuery(event).color || undefined;
   const strokeWidth = getQuery(event).strokeWidth || undefined;
+  const background = getQuery(event).background || undefined;
 
   const LucideIcon = createLucideIcon(params.iconName, iconNode);
 
@@ -32,6 +33,7 @@ export default eventHandler((event) => {
         height,
         color: color ? `#${color}` : undefined,
         strokeWidth,
+        style: background ? { background } : undefined,
       }),
     ),
   ).toString('utf8');

docs/.vitepress/api/tags/index.get.ts

@@ -1,3 +1,4 @@
+import { eventHandler, setResponseHeader } from 'h3';
 import iconMetaData from '../../data/iconMetaData';
 
 export default eventHandler((event) => {

docs/.vitepress/api/test.ts

@@ -1,3 +0,0 @@
-export default eventHandler(() => {
-  return { nitro: 'Is Awesome! asda' };
-});

docs/.vitepress/config.ts

@@ -1,6 +1,19 @@
 import { fileURLToPath, URL } from 'node:url';
 import { defineConfig } from 'vitepress';
+import { groupIconMdPlugin, groupIconVitePlugin } from 'vitepress-plugin-group-icons';
 import sidebar from './sidebar';
+import snackPlayer from './markdown/snackPlayer';
+import sandpackPlugin from './markdown/sandpack';
+import { readFile } from 'node:fs/promises';
+import { resourcesSidebar } from './sidebar/resources';
+import getStructuredData from './getStructuredData';
+import { createGeneralOGImage, createIconOGImage } from './createOGImage';
+import llmstxt from 'vitepress-plugin-llms';
+
+const defaultSandpackCSS = await readFile(
+  fileURLToPath(new URL('./theme/sandpack-default.css', import.meta.url)),
+  'utf-8',
+);
 
 const title = 'Lucide';
 const socialTitle = 'Lucide Icons';
@@ -9,10 +22,25 @@ const description = 'Beautiful & consistent icon toolkit made by the community.'
 // https://vitepress.dev/reference/site-config
 export default defineConfig({
   title,
+  titleTemplate: ':title \u2013 Lucide',
   description,
   cleanUrls: true,
   outDir: '.vercel/output/static',
   srcExclude: ['**/README.md'],
+  markdown: {
+    config(md) {
+      md.use(groupIconMdPlugin);
+      md.use(snackPlayer);
+      md.use(sandpackPlugin, {
+        defaultFiles: {
+          '/styles.css': {
+            code: defaultSandpackCSS,
+            hidden: true,
+          },
+        },
+      });
+    },
+  },
   vite: {
     resolve: {
       alias: [
@@ -34,6 +62,19 @@ export default defineConfig({
         },
       ],
     },
+    plugins: [
+      groupIconVitePlugin(),
+      llmstxt({
+        ignoreFiles: [
+          'code-of-conduct.md',
+          'index.md',
+          'packages.md',
+          'showcase.md',
+          'brand-logo-statement.md',
+          'icons/**', // Not working, need investigation
+        ],
+      }),
+    ],
   },
   head: [
     [
@@ -150,8 +191,82 @@ export default defineConfig({
       },
     ],
   ],
+  async transformPageData(pageData) {
+    pageData.frontmatter.head ??= [];
+    if (
+      pageData.relativePath.startsWith('icons/') &&
+      !pageData.relativePath.startsWith('icons/lab/') &&
+      pageData.params?.name
+    ) {
+      const iconName = pageData.params.name;
+      pageData.title = `${iconName} icon details`;
+
+      const taggedAs = pageData.params?.tags?.length
+        ? `Tagged as: ${pageData.params.tags.join(', ')}.`
+        : '';
+      const categorizedIn = pageData.params?.category?.length
+        ? `Categorized in: ${pageData.params.category.join(', ')}.`
+        : '';
+
+      pageData.description =
+        `Details and related icons for ${iconName} icon. ${taggedAs} ${categorizedIn}`.trim();
+
+      const structuredData = await getStructuredData(iconName, pageData);
+
+      const ogPath = await createIconOGImage(iconName, pageData.params?.tags || []);
+
+      if (ogPath) {
+        const content = `https://lucide.dev${ogPath}`;
+        pageData.frontmatter.head.push(
+          [
+            'meta',
+            {
+              property: 'og:image',
+              content,
+            },
+          ],
+          [
+            'meta',
+            {
+              property: 'twitter:image',
+              content,
+            },
+          ],
+        );
+      }
+
+      pageData.frontmatter.head.push([
+        'script',
+        { type: 'application/ld+json' },
+        JSON.stringify(structuredData),
+      ]);
+    }
+
+    if (pageData.relativePath.startsWith('guide/')) {
+      const ogPath = await createGeneralOGImage(pageData);
+
+      if (ogPath) {
+        const content = `https://lucide.dev${ogPath}`;
+        pageData.frontmatter.head.push(
+          [
+            'meta',
+            {
+              property: 'og:image',
+              content,
+            },
+          ],
+          [
+            'meta',
+            {
+              property: 'twitter:image',
+              content,
+            },
+          ],
+        );
+      }
+    }
+  },
   themeConfig: {
-    // https://vitepress.dev/reference/default-theme-config
     logo: {
       light: '/logo.light.svg',
       dark: '/logo.dark.svg',
@@ -159,9 +274,15 @@ export default defineConfig({
     nav: [
       { text: 'Icons', link: '/icons/' },
       { text: 'Guide', link: '/guide/' },
+      {
+        text: 'Resources',
+        items: [
+          ...resourcesSidebar[0].items,
+          { text: 'Design icons', link: '/contribute/icon-design-guide' },
+        ],
+      },
       { text: 'Packages', link: '/packages' },
       { text: 'Showcase', link: '/showcase' },
-      { text: 'License', link: '/license' },
     ],
     sidebar,
     socialLinks: [

docs/.vitepress/createOGImage.ts

@@ -0,0 +1,79 @@
+import { PageData } from 'vitepress';
+import fs from 'node:fs/promises';
+import { cwd } from 'node:process';
+import { join } from 'node:path';
+import sharp from 'sharp';
+
+const generalSVGTemplate = fs.readFile(join(cwd(), '.vitepress/lib/guideOGTemplate.svg'), 'utf-8');
+
+export async function createGeneralOGImage({ title, description, relativePath }: PageData) {
+  const fileName = relativePath.replace(/\.md$/, '.png').replace(/\//g, '-');
+
+  const path = join(cwd(), 'public/og', fileName);
+
+  let desc = description.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+  if (!desc) {
+    desc = '';
+  }
+  const lines = desc.replace(/(?![^\n]{1,64}$)([^\n]{1,64})\s/g, '$1\n').split('\n');
+  const data = {
+    title: title,
+    line1: lines[0] || '',
+    line2: lines[1] || '',
+    line3: lines[2] || '',
+    line4: lines[3] || '',
+  };
+  const svgTemplate = await generalSVGTemplate;
+  const svg = svgTemplate.replace(/\{\{([^}]+)\}\}/g, (_, name: keyof typeof data) => data[name]);
+
+  console.log(`Generating ${fileName}`);
+  try {
+    await sharp(Buffer.from(svg))
+      .resize(1200 * 1.1, 630 * 1.1)
+      .png()
+      .toFile(path);
+  } catch (e) {
+    console.error('Error generating', { filename: path, ...data, svg });
+    console.error(e);
+  }
+
+  return `/og/${fileName}`;
+}
+
+const iconSVGTemplate = fs.readFile(join(cwd(), '.vitepress/lib/iconOGTemplate.svg'), 'utf-8');
+
+export async function createIconOGImage(iconName: string, tags: string[]) {
+  const path = join(cwd(), 'public/og', `icon-${iconName}.png`);
+
+  let iconSVG = await fs.readFile(join(cwd(), `../icons/${iconName}.svg`), 'utf-8');
+  iconSVG = iconSVG
+    .replace('width="24"', 'width="320"')
+    .replace('height="24"', 'height="320"')
+    .replace('currentColor', '#dfdfd6')
+    .replace(
+      'xmlns="http://www.w3.org/2000/svg"',
+      'xmlns="http://www.w3.org/2000/svg" x="62" y="66"',
+    );
+
+  const data = {
+    name: iconName,
+    tags: tags.join(' • ').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/&/g, '&amp;'),
+    iconSVG,
+  };
+
+  const svgTemplate = await iconSVGTemplate;
+  const svg = svgTemplate.replace(/\{\{([^}]+)\}\}/g, (_, name: keyof typeof data) => data[name]);
+
+  console.log(`Generating ${path}`);
+  try {
+    await sharp(Buffer.from(svg))
+      .resize(1200 * 1.1, 630 * 1.1)
+      .png()
+      .toFile(path);
+  } catch (e) {
+    console.error('Error generating', { filename: path, ...data, svg });
+    console.error(e);
+  }
+
+  return `/og/icon-${iconName}.png`;
+}

docs/.vitepress/data/categoriesData.json

@@ -15,10 +15,6 @@
     "name": "arrows",
     "title": "Arrows"
   },
-  {
-    "name": "brands",
-    "title": "Brands"
-  },
   {
     "name": "buildings",
     "title": "Buildings"
@@ -101,7 +97,7 @@
   },
   {
     "name": "navigation",
-    "title": "Navigation"
+    "title": "Navigation, Maps, and POIs"
   },
   {
     "name": "notifications",

docs/.vitepress/data/companiesData.json

@@ -7,6 +7,14 @@
       "dark": "/company-logos/vercel-dark.svg"
     }
   },
+  {
+    "name": "MDN Web Docs",
+    "url": "https://developer.mozilla.org/",
+    "image": {
+      "light": "/company-logos/mdn-light.svg",
+      "dark": "/company-logos/mdn-dark.svg"
+    }
+  },
   {
     "name": "Supabase",
     "url": "https://supabase.com",
@@ -23,6 +31,14 @@
       "dark": "/company-logos/obsidian-dark.svg"
     }
   },
+  {
+    "name": "Nuxt",
+    "url": "https://nuxt.com/",
+    "image": {
+      "light": "/company-logos/nuxt-light.svg",
+      "dark": "/company-logos/nuxt-dark.svg"
+    }
+  },
   {
     "name": "Open Collective",
     "url": "https://opencollective.com",

docs/.vitepress/data/packageData.json

@@ -18,6 +18,7 @@
   "lucide-react": {
     "order": 1,
     "icon": "react",
+    "docsAlias": "react",
     "shields": [
       {
         "alt": "npm",
@@ -31,25 +32,28 @@
       }
     ]
   },
-  "lucide-vue-next": {
+  "@lucide/vue": {
     "order": 2,
-    "icon": "vue-next",
+    "icon": "vue",
+    "docsAlias": "vue",
+    "packageDirname": "vue",
     "shields": [
       {
         "alt": "npm",
-        "src": "https://img.shields.io/npm/v/lucide-vue-next",
-        "href": "https://www.npmjs.com/package/lucide-vue-next"
+        "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-next",
-        "href": "https://www.npmjs.com/package/lucide-vue-next"
+        "src": "https://img.shields.io/npm/dw/@lucide/vue",
+        "href": "https://www.npmjs.com/package/@lucide/vue"
       }
     ]
   },
   "lucide-svelte": {
     "order": 3,
     "icon": "svelte",
+    "docsAlias": "svelte",
     "shields": [
       {
         "alt": "npm",
@@ -66,6 +70,7 @@
   "lucide-solid": {
     "order": 4,
     "icon": "solid",
+    "docsAlias": "solid",
     "shields": [
       {
         "alt": "npm",
@@ -82,6 +87,7 @@
   "lucide-react-native": {
     "order": 5,
     "icon": "react-native",
+    "docsAlias": "react-native",
     "shields": [
       {
         "alt": "npm",
@@ -95,9 +101,28 @@
       }
     ]
   },
-  "lucide-angular": {
+  "@lucide/angular": {
     "order": 6,
     "icon": "angular",
+    "docsAlias": "angular",
+    "shields": [
+      {
+        "alt": "npm",
+        "src": "https://img.shields.io/npm/v/@lucide/angular",
+        "href": "https://www.npmjs.com/package/@lucide/angular"
+      },
+      {
+        "alt": "npm",
+        "src": "https://img.shields.io/npm/dw/@lucide/angular",
+        "href": "https://www.npmjs.com/package/@lucide/angular"
+      }
+    ]
+  },
+  "lucide-angular": {
+    "order": 7,
+    "icon": "angular-old",
+    "description": "Our legacy Angular package with a module based API.",
+    "documentation": "https://v0.lucide.dev/guide/packages/lucide-angular",
     "shields": [
       {
         "alt": "npm",
@@ -112,8 +137,9 @@
     ]
   },
   "lucide-preact": {
-    "order": 7,
+    "order": 8,
     "icon": "preact",
+    "docsAlias": "preact",
     "shields": [
       {
         "alt": "npm",
@@ -128,9 +154,9 @@
     ]
   },
   "@lucide/astro": {
-    "docsAlias": "lucide-astro",
+    "docsAlias": "astro",
     "packageDirname": "astro",
-    "order": 8,
+    "order": 9,
     "icon": "astro",
     "iconDark": "astro-dark",
     "shields": [
@@ -147,8 +173,9 @@
     ]
   },
   "lucide-static": {
-    "order": 9,
+    "order": 10,
     "icon": "svg",
+    "docsAlias": "static",
     "shields": [
       {
         "alt": "npm",
@@ -161,5 +188,24 @@
         "href": "https://www.npmjs.com/package/lucide-static"
       }
     ]
+  },
+  "@lucide/icons": {
+    "hide": true,
+    "docsAlias": "icons",
+    "packageDirname": "icons",
+    "order": 10,
+    "icon": "ts",
+    "shields": [
+      {
+        "alt": "npm",
+        "src": "https://img.shields.io/npm/v/@lucide/icons",
+        "href": "https://www.npmjs.com/package/@lucide/icons"
+      },
+      {
+        "alt": "npm",
+        "src": "https://img.shields.io/npm/dw/@lucide/icons",
+        "href": "https://www.npmjs.com/package/@lucide/icons"
+      }
+    ]
   }
 }

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

@@ -77,8 +77,8 @@
     "source": "https://github.com/swisnl/nuxt-lucide-icons",
     "documentation": "https://github.com/swisnl/nuxt-lucide-icons/blob/main/README.md"
   },
-    {
-    "name": "lucide-lustre",
+  {
+    "name": "lucide_lustre",
     "description": "A library providing https://lucide.dev icons to lustre.",
     "icon": "/framework-logos/lustre.webp",
     "shields": [
@@ -95,5 +95,119 @@
     ],
     "source": "https://github.com/dinkelspiel/lucide_lustre",
     "documentation": "https://github.com/dinkelspiel/lucide_lustre/blob/master/README.md"
+  },
+  {
+    "name": "lucide_icons_flutter",
+    "description": "A library providing https://lucide.dev icons to Flutter.",
+    "icon": "/framework-logos/flutter.svg",
+    "shields": [
+      {
+        "alt": "Latest Stable Version",
+        "src": "https://img.shields.io/pub/v/lucide_icons_flutter",
+        "href": "https://pub.dev/packages/lucide_icons_flutter"
+      },
+      {
+        "alt": "Total Downloads",
+        "src": "https://img.shields.io/pub/dm/lucide_icons_flutter",
+        "href": "https://pub.dev/packages/lucide_icons_flutter"
+      }
+    ],
+    "source": "https://github.com/vqh2602/lucide-flutter-main",
+    "documentation": "https://pub.dev/documentation/lucide_icons_flutter/latest/"
+  },
+  {
+    "name": "lucide-slint",
+    "description": "Implementation of the Lucide icon library for Slint.",
+    "icon": "/framework-logos/slint.svg",
+    "shields": [
+      {
+        "alt": "Latest Stable Version",
+        "src": "https://img.shields.io/crates/v/lucide-slint",
+        "href": "https://crates.io/crates/lucide-slint"
+      },
+      {
+        "alt": "Total Downloads",
+        "src": "https://img.shields.io/crates/d/lucide-slint",
+        "href": "https://crates.io/crates/lucide-slint"
+      }
+    ],
+    "source": "https://github.com/cnlancehu/lucide-slint",
+    "documentation": "https://github.com/cnlancehu/lucide-slint/blob/main/README.md"
+  },
+  {
+    "name": "lucide-go",
+    "description": "Implementation of Lucide icons for Go's html/template package.",
+    "icon": "/framework-logos/go.svg",
+    "shields": [
+      {
+        "alt": "Latest Stable Version",
+        "src": "https://img.shields.io/github/v/release/kaugesaar/lucide-go",
+        "href": "https://github.com/kaugesaar/lucide-go/releases"
+      },
+      {
+        "alt": "Go Reference",
+        "src": "https://pkg.go.dev/badge/github.com/kaugesaar/lucide-go.svg",
+        "href": "https://pkg.go.dev/github.com/kaugesaar/lucide-go"
+      }
+    ],
+    "source": "https://github.com/kaugesaar/lucide-go",
+    "documentation": "https://github.com/kaugesaar/lucide-go/blob/master/README.md"
+  },
+  {
+    "name": "lucide-rails",
+    "description": "Ruby on Rails views helper method for rendering Lucide icons.",
+    "icon": "/framework-logos/rails.svg",
+    "shields": [
+      {
+        "alt": "Latest Stable Version",
+        "src": "https://img.shields.io/gem/v/lucide-rails",
+        "href": "https://rubygems.org/gems/lucide-rails"
+      },
+      {
+        "alt": "Total Downloads",
+        "src": "https://img.shields.io/gem/dt/lucide-rails",
+        "href": "https://rubygems.org/gems/lucide-rails"
+      }
+    ],
+    "source": "https://github.com/heyvito/lucide-rails",
+    "documentation": "https://github.com/heyvito/lucide-rails/blob/master/README.md"
+  },
+  {
+    "name": "lucide-web-components",
+    "description": "Implementation of Lucide icons in Web Components custom elements.",
+    "icon": "/framework-logos/web-components.svg",
+    "shields": [
+      {
+        "alt": "Latest Stable Version",
+        "src": "https://img.shields.io/npm/v/@dile/iconlib",
+        "href": "https://dile-components.com/icons/lucide-icons/"
+      },
+      {
+        "alt": "Total Downloads",
+        "src": "https://img.shields.io/npm/dt/@dile/iconlib",
+        "href": "https://dile-components.com/icons/lucide-icons/"
+      }
+    ],
+    "source": "https://github.com/Polydile/dile-components",
+    "documentation": "https://github.com/Polydile/dile-components/blob/master/packages/iconlib/README.md"
+  },
+  {
+    "name": "strapi-lucide-icons",
+    "description": "Lucide icon picker custom field for Strapi.",
+    "icon": "/framework-logos/strapi.svg",
+    "shields": [
+      {
+        "alt": "Latest Stable Version",
+        "src": "https://img.shields.io/npm/v/strapi-lucide-icons",
+        "href": "https://www.npmjs.com/package/strapi-lucide-icons"
+      },
+      {
+        "alt": "Total Downloads",
+        "src": "https://img.shields.io/npm/dw/strapi-lucide-icons",
+        "href": "https://www.npmjs.com/package/strapi-lucide-icons"
+      }
+    ],
+    "source": "https://github.com/shx08/strapi-lucide-icons",
+    "documentation": "https://github.com/shx08/strapi-lucide-icons/blob/main/README.md"
   }
 ]

docs/.vitepress/getStructuredData.ts

@@ -0,0 +1,46 @@
+import { PageData } from 'vitepress';
+
+export default async function getStructuredData(iconName: string, pageData: PageData) {
+  const url = `https://lucide.dev/icons/${iconName}`;
+
+  return {
+    '@context': 'https://schema.org',
+    '@type': 'WebPage',
+    '@id': url,
+    name: pageData.title,
+    description: pageData.description,
+    url,
+    inLanguage: 'en',
+    isPartOf: {
+      '@type': 'WebSite',
+      name: 'Lucide Icons',
+      url: 'https://lucide.dev',
+    },
+    breadcrumb: {
+      '@type': 'BreadcrumbList',
+      itemListElement: [
+        { '@type': 'ListItem', position: 1, name: 'Icons', item: 'https://lucide.dev/icons' },
+        { '@type': 'ListItem', position: 2, name: iconName, item: url },
+      ],
+    },
+    mainEntity: {
+      '@type': 'ImageObject',
+      '@id': `${url}#icon`,
+      name: iconName,
+      // TODO: Add support for description extraction from icon metadata
+      // description: 'An ...SVG icon from the Lucide icon set.',
+      contentUrl: `https://lucide.dev/api/icons/${iconName}}?width=24&height=24&background=white`,
+      thumbnailUrl: `https://lucide.dev/api/icons/${iconName}}?width=256&height=256&background=white`,
+      encodingFormat: 'image/svg+xml',
+      keywords: pageData.params?.tags,
+      width: 24,
+      height: 24,
+      creator: {
+        '@type': 'Organization',
+        name: 'Lucide Icons',
+      },
+      datePublished: pageData?.params?.createdRelease?.date,
+      dateModified: pageData?.params?.changedRelease?.date,
+    },
+  };
+}

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

@@ -1,4 +1,4 @@
-import React from 'react';
+import React, { Fragment } from 'react';
 
 interface BackdropProps {
   src: string;
@@ -53,8 +53,8 @@ const Backdrop = ({
         <rect
           x="0"
           y="0"
-          width="24"
-          height="24"
+          width="100%"
+          height="100%"
           fill="#fff"
           stroke="none"
         />
@@ -67,8 +67,8 @@ const Backdrop = ({
         <rect
           x="0"
           y="0"
-          width="24"
-          height="24"
+          width="100%"
+          height="100%"
           opacity={0.5}
           fill={`url(#pattern-${id})`}
           stroke="none"

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

@@ -7,15 +7,17 @@ const SvgPreview = React.forwardRef<
   {
     oldSrc: string;
     newSrc: string;
+    height: number;
+    width: number;
   } & React.SVGProps<SVGSVGElement>
->(({ oldSrc, newSrc, children, ...props }, ref) => {
+>(({ oldSrc, newSrc, children, height, width, ...props }, ref) => {
   return (
     <svg
       ref={ref}
       xmlns="http://www.w3.org/2000/svg"
-      width={24}
-      height={24}
-      viewBox="0 0 24 24"
+      width={width}
+      height={height}
+      viewBox={`0 0 ${width} ${height}`}
       fill="none"
       stroke="currentColor"
       strokeWidth={2}
@@ -25,6 +27,8 @@ const SvgPreview = React.forwardRef<
     >
       <style>{darkModeCss}</style>
       <Grid
+        width={width}
+        height={height}
         strokeWidth={0.1}
         stroke="#777"
         strokeOpacity={0.3}
@@ -37,8 +41,8 @@ const SvgPreview = React.forwardRef<
         <rect
           x="0"
           y="0"
-          width="24"
-          height="24"
+          width="100%"
+          height="100%"
           fill="#000"
           stroke="none"
         />

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

@@ -1,4 +1,4 @@
-import React from 'react';
+import React, { Fragment } from 'react';
 import { PathProps, Path } from './types';
 import getPaths, { assert } from './utils';
 import { GapViolationHighlight } from './GapViolationHighlight.tsx';
@@ -389,15 +389,18 @@ const Handles = ({
   </g>
 );
 
-const SvgPreview = React.forwardRef<
-  SVGSVGElement,
-  {
-    height?: number;
-    width?: number;
-    src: string | ReturnType<typeof getPaths>;
-    showGrid?: boolean;
-  } & React.SVGProps<SVGSVGElement>
->(({ src, children, height = 24, width = 24, showGrid = false, ...props }, ref) => {
+interface SvgPreviewProps extends React.SVGProps<SVGSVGElement> {
+  height?: number;
+  width?: number;
+  src: string | ReturnType<typeof getPaths>;
+  showGrid?: boolean;
+  children?: React.ReactNode;
+}
+
+const SvgPreview = (
+  { src, children, height = 24, width = 24, showGrid = false, ...props }: SvgPreviewProps,
+  ref,
+) => {
   const subGridSize =
     Math.max(height, width) % 3 === 0
       ? Math.max(height, width) > 24
@@ -456,20 +459,7 @@ const SvgPreview = React.forwardRef<
       />
       <ColoredPath
         paths={paths}
-        colors={[
-          '#1982c4',
-          '#4267AC',
-          '#6a4c93',
-          '#B55379',
-          '#FF595E',
-          '#FF7655',
-          '#ff924c',
-          '#FFAE43',
-          '#ffca3a',
-          '#C5CA30',
-          '#8ac926',
-          '#52A675',
-        ]}
+        colors={['#dfdfd6']}
       />
       <Radii
         paths={paths}
@@ -494,7 +484,7 @@ const SvgPreview = React.forwardRef<
       {children}
     </svg>
   );
-});
+};
 
 SvgPreview.displayName = 'SvgPreview';
 

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

@@ -1,4 +1,4 @@
-import memoize from 'lodash/memoize';
+import { memoize } from 'lodash-es';
 import SVGPathCommander from 'svg-path-commander';
 import { Path } from './types';
 

docs/.vitepress/lib/SvgPreview/types.ts

@@ -8,7 +8,7 @@ export type Path = {
   prev: Point;
   next: Point;
   isStart: boolean;
-  circle?: { x: number; y: number; r: number };
+  circle?: { x: number; y: number; r: number; tangentIntersection?: Point };
   cp1?: Point;
   cp2?: Point;
   c: ReturnType<typeof getCommands>[number];

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

@@ -1,10 +1,8 @@
 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';
+import { memoize } from 'lodash-es';
 
 function assertNever(x: never): never {
   throw new Error('Unknown type: ' + x['type']);

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

@@ -1,4 +1,4 @@
-import { bundledLanguages, getHighlighter, type ThemeRegistration } from 'shikiji';
+import { bundledLanguages, createHighlighter, type ThemeRegistration } from 'shiki';
 
 type CodeExampleType = {
   title: string;
@@ -9,14 +9,20 @@ type CodeExampleType = {
 const getIconCodes = (): CodeExampleType => {
   return [
     {
-      language: 'js',
+      language: 'html',
       title: 'Vanilla',
       code: `\
-import { createIcons, icons } from 'lucide';
+<script>
+import { createIcons, $CamelCase } from 'lucide';
 
-createIcons({ icons });
+createIcons({
+  icons: {
+    $CamelCase
+  }
+});
+</script>
 
-document.body.append('<i data-lucide="$Name"></i>');\
+<i data-lucide="$Name"></i>\
   `,
     },
     {
@@ -37,7 +43,7 @@ export default App;
       language: 'vue',
       title: 'Vue',
       code: `<script setup>
-import { $PascalCase } from 'lucide-vue-next';
+import { $PascalCase } from '@lucide/vue';
 </script>
 
 <template>
@@ -107,16 +113,16 @@ import { LucideAngularModule, $PascalCase } from 'lucide-angular';
   ];
 };
 
+const highlighter = await createHighlighter({
+  themes: ['github-light', 'github-dark'],
+  langs: Object.keys(bundledLanguages),
+});
+
 export type ThemeOptions =
   | ThemeRegistration
   | { light: ThemeRegistration; dark: ThemeRegistration };
 
-const highLightCode = async (code: string, lang: string, active?: boolean) => {
-  const highlighter = await getHighlighter({
-    themes: ['github-light', 'github-dark'],
-    langs: Object.keys(bundledLanguages),
-  });
-
+export const highLightCode = async (code: string, lang: string, active?: boolean) => {
   const highlightedCode = highlighter
     .codeToHtml(code, {
       lang,

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

@@ -1,5 +1,4 @@
-import { bundledLanguages, type ThemeRegistration } from 'shikiji';
-import { getHighlighter } from 'shikiji';
+import { highLightCode } from './createCodeExamples';
 
 type CodeExampleType = {
   title: string;
@@ -10,10 +9,11 @@ type CodeExampleType = {
 const getIconCodes = (): CodeExampleType => {
   return [
     {
-      language: 'js',
+      language: 'html',
       title: 'Vanilla',
       code: `\
-import { createIcons, icons } from 'lucide';
+<script>
+import { createIcons } from 'lucide';
 import { $CamelCase } from '@lucide/lab';
 
 createIcons({
@@ -21,8 +21,9 @@ createIcons({
     $CamelCase
   }
 });
+</script>
 
-document.body.append('<i data-lucide="$Name"></i>');\
+<i data-lucide="$Name"></i>\
   `,
     },
     {
@@ -103,45 +104,17 @@ import { $CamelCase } from '@lucide/lab';
 
 @NgModule({
   imports: [
-    LucideAngularModule.pick({ $CamelCase })
+    LucideAngularModule.pick({ $PascalCase: $CamelCase })
   ],
 })
 
 // app.component.html
-<lucide-icon name="$CamelCase"></lucide-icon>
+<lucide-icon name="$PascalCase"></lucide-icon>
 `,
     },
   ];
 };
 
-export type ThemeOptions =
-  | ThemeRegistration
-  | { light: ThemeRegistration; dark: ThemeRegistration };
-
-const highLightCode = async (code: string, lang: string, active?: boolean) => {
-  const highlighter = await getHighlighter({
-    themes: ['github-light', 'github-dark'],
-    langs: Object.keys(bundledLanguages),
-  });
-
-  const highlightedCode = highlighter
-    .codeToHtml(code, {
-      lang,
-      themes: {
-        light: 'github-light',
-        dark: 'github-dark',
-      },
-      defaultColor: false,
-    })
-    .replace('shiki-themes', 'shiki-themes vp-code');
-
-  return `<div class="language-${lang} ${active ? 'active' : ''}">
-  <button title="Copy Code" class="copy"></button>
-  <span class="lang">${lang}</span>
-  ${highlightedCode}
-  </div>`;
-};
-
 export default async function createCodeExamples() {
   const codes = getIconCodes();
 

docs/.vitepress/lib/codeExamples/highLightCode.ts

@@ -1,12 +1,12 @@
-import { bundledLanguages, type ThemeRegistration } from 'shikiji';
-import { getHighlighter } from 'shikiji';
+import { bundledLanguages, type ThemeRegistration } from 'shiki';
+import { createHighlighter } from 'shiki';
 
 export type ThemeOptions =
   | ThemeRegistration
   | { light: ThemeRegistration; dark: ThemeRegistration };
 
 const highLightCode = async (code: string, lang: string, active?: boolean) => {
-  const highlighter = await getHighlighter({
+  const highlighter = await createHighlighter({
     themes: ['github-light', 'github-dark'],
     langs: Object.keys(bundledLanguages),
   });

docs/.vitepress/lib/getFallbackZip.tsx

@@ -1,5 +1,5 @@
 import { createLucideIcon } from 'lucide-react/src/lucide-react';
-import { type LucideProps, type IconNode } from 'lucide-react/src/createLucideIcon';
+import { type LucideProps, type IconNode } from 'lucide-react/src/types';
 import { IconEntity } from '../theme/types';
 import { renderToStaticMarkup } from 'react-dom/server';
 import { IconContent } from './generateZip';

docs/.vitepress/lib/guideOGTemplate.svg

@@ -0,0 +1,35 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 630" width="1200" height="630" fill="none">
+  <g clip-path="url(#a)">
+    <path fill="#1b1b1f" d="M0 0h1200v630H0z" />
+    <text xml:space="preserve" fill="#fff" font-family="Inter, Helvetica, sans-serif" font-size="44" font-weight="600"
+      letter-spacing=".05em" style="white-space:pre">
+      <tspan x="62" y="118.5">{{title}}</tspan>
+    </text>
+    <text xml:space="preserve" fill="#ebebf5" fill-opacity=".8" font-family="Inter, Helvetica, sans-serif"
+      font-size="32" letter-spacing="0em" opacity=".79" style="white-space:pre">
+      <tspan x="62" y="209.14">{{line1}}</tspan>
+      <tspan x="62" y="257.14">{{line2}}</tspan>
+      <tspan x="62" y="305.14">{{line3}}</tspan>
+      <tspan x="62" y="353.14">{{line4}}</tspan>
+    </text>
+    <path fill="#161618" d="M0 438h1200v192H0z" />
+    <path fill="#e7e7e7"
+      d="M395.33 562.28q-5.97 0-10.31-2.5a17 17 0 0 1-6.64-7.13q-2.32-4.64-2.32-10.91 0-6.18 2.32-10.84a17.7 17.7 0 0 1 6.56-7.29q4.2-2.63 9.9-2.63 3.66 0 6.92 1.2 3.28 1.17 5.78 3.64a17 17 0 0 1 3.98 6.3 26 26 0 0 1 1.45 9.07v2.89h-32.52v-6.36H404q-.03-2.7-1.17-4.81a8.5 8.5 0 0 0-3.17-3.36 9 9 0 0 0-4.7-1.23q-2.88 0-5.04 1.4a9.7 9.7 0 0 0-3.39 3.65q-1.19 2.25-1.21 4.93v5.54q0 3.5 1.27 6a9 9 0 0 0 3.53 3.8q2.29 1.3 5.32 1.3 2.05 0 3.7-.58a8 8 0 0 0 2.87-1.74 7 7 0 0 0 1.83-2.84l8.73 1a14 14 0 0 1-3.15 6.09 15.4 15.4 0 0 1-5.89 4q-3.6 1.41-8.21 1.41M346.67 562.2q-4.67 0-8.37-2.42a16.4 16.4 0 0 1-5.84-7.03q-2.14-4.6-2.14-11.2 0-6.67 2.17-11.25a16 16 0 0 1 5.91-6.95 15 15 0 0 1 8.3-2.37q3.48 0 5.73 1.2 2.25 1.17 3.56 2.84 1.32 1.63 2.05 3.1h.38v-19.95h9.38v53.33h-9.2v-6.3h-.56q-.74 1.45-2.1 3.1-1.37 1.61-3.61 2.76a12.4 12.4 0 0 1-5.66 1.14m2.6-7.73q2.99 0 5.07-1.62a10 10 0 0 0 3.18-4.55 19 19 0 0 0 1.08-6.8 19 19 0 0 0-1.08-6.74 9.6 9.6 0 0 0-3.15-4.46 8 8 0 0 0-5.1-1.59 8.2 8.2 0 0 0-5.2 1.64 10 10 0 0 0-3.16 4.54 19 19 0 0 0-1.06 6.61q0 3.75 1.06 6.7a10.5 10.5 0 0 0 3.18 4.6 8 8 0 0 0 5.19 1.67M312.98 561.5v-40h9.35v40zm4.7-45.68q-2.22 0-3.82-1.48a4.8 4.8 0 0 1-1.6-3.62q0-2.13 1.6-3.62a5.4 5.4 0 0 1 3.82-1.51q2.25 0 3.82 1.51 1.6 1.49 1.6 3.62a4.8 4.8 0 0 1-1.6 3.62 5.4 5.4 0 0 1-3.82 1.48M288.3 562.28q-5.93 0-10.2-2.63-4.23-2.62-6.53-7.26a24 24 0 0 1-2.27-10.73q0-6.1 2.32-10.76a17.4 17.4 0 0 1 6.56-7.29 19 19 0 0 1 10.07-2.63q4.83 0 8.56 1.8a14.6 14.6 0 0 1 5.96 5.02 15 15 0 0 1 2.53 7.55h-8.93a8.6 8.6 0 0 0-2.59-4.81q-2.01-1.95-5.4-1.96a8.4 8.4 0 0 0-5.03 1.57 10 10 0 0 0-3.39 4.42 18 18 0 0 0-1.19 6.93q0 4.1 1.2 7.03 1.19 2.93 3.33 4.5a8.5 8.5 0 0 0 5.08 1.57q2.07 0 3.7-.78a7.5 7.5 0 0 0 2.76-2.32q1.11-1.5 1.53-3.67h8.93a16 16 0 0 1-2.48 7.52 14.7 14.7 0 0 1-5.83 5.1 19.4 19.4 0 0 1-8.68 1.83M252.04 544.68V521.5h9.34v40h-9.06v-7.11h-.41a12 12 0 0 1-4.42 5.5q-3.05 2.13-7.52 2.13-3.9 0-6.9-1.74a12 12 0 0 1-4.64-5.13 18 18 0 0 1-1.68-8.18V521.5h9.35v24.01q0 3.8 2.06 6.04a7 7 0 0 0 5.43 2.24q2.07 0 4-1.01a8 8 0 0 0 3.18-3.02 9.4 9.4 0 0 0 1.26-5.08M185.96 561.5v-53.33h9.58v45.23h23.3v8.1zM117.1 534c0-7.6-6.1-13.75-13.64-13.75A13.7 13.7 0 0 0 89.82 534c0 17.72 14.25 32.08 31.83 32.08s31.82-14.36 31.82-32.08a50.5 50.5 0 0 0-16.67-37.58 4.6 4.6 0 0 1-.36-6.47 4.5 4.5 0 0 1 6.42-.36 59.7 59.7 0 0 1 19.7 44.4l-.05 2.13c-1.1 21.8-18.97 39.13-40.86 39.13-22.6 0-40.92-18.47-40.92-41.25a22.8 22.8 0 0 1 22.73-22.92A22.8 22.8 0 0 1 126.2 534a4.56 4.56 0 0 1-4.55 4.58 4.56 4.56 0 0 1-4.54-4.58" />
+    <path fill="#f56565"
+      d="M98.91 534a4.56 4.56 0 0 1 4.55-4.58 4.57 4.57 0 0 1 4.55 4.58c0 7.6 6.1 13.75 13.63 13.75 7.3 0 13.26-5.78 13.62-13.04l.02-.71c0-17.72-14.24-32.08-31.82-32.08S71.64 516.28 71.64 534a50.5 50.5 0 0 0 16.93 37.81 4.6 4.6 0 0 1 .4 6.48 4.53 4.53 0 0 1-6.42.4 59.7 59.7 0 0 1-19.98-43.03l-.02-1.66c0-22.78 18.31-41.25 40.91-41.25s40.92 18.47 40.92 41.25l-.04 1.18a22.8 22.8 0 0 1-22.7 21.74A22.8 22.8 0 0 1 98.92 534" />
+    <text xml:space="preserve" fill="#ebebf5" fill-opacity=".8" font-family="Inter, Helvetica, sans-serif"
+      font-size="39" font-weight="500" letter-spacing="0em" style="white-space:pre">
+      <tspan x="808.98" y="548.18">https://lucide.dev</tspan>
+    </text>
+    <path fill="url(#b)" d="M1116 0h84v435h-84z" />
+  </g>
+  <defs>
+    <linearGradient id="b" x1="1200" x2="1116" y1="218" y2="218" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#1b1b1f" />
+      <stop offset="1" stop-color="#1b1b1f" stop-opacity="0" />
+    </linearGradient>
+    <clipPath id="a">
+      <path fill="#fff" d="M0 0h1200v630H0z" />
+    </clipPath>
+  </defs>
+</svg>

docs/.vitepress/lib/iconOGTemplate.svg

@@ -0,0 +1,47 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="630" fill="none">
+  <g clip-path="url(#a)">
+    <path fill="#1b1b1f" d="M0 0h1200v630H0z" />
+    <g clip-path="url(#b)">
+      <rect width="320" height="320" x="62" y="66" fill="#161618" rx="24" />
+      <path stroke="#202127"
+        d="M62 79.33h320M75.33 66v320M62 92.67h320M88.67 66v320M62 106h320M102 66v320M62 119.33h320M115.33 66v320M62 132.67h320M128.67 66v320M62 146h320M142 66v320M62 159.33h320M155.33 66v320M62 172.67h320M168.67 66v320M62 186h320M182 66v320M62 199.33h320M195.33 66v320M62 212.67h320M208.67 66v320M62 226h320M222 66v320M62 239.33h320M235.33 66v320M62 252.67h320M248.67 66v320M62 266h320M262 66v320M62 279.33h320M275.33 66v320M62 292.67h320M288.67 66v320M62 306h320M302 66v320M62 319.33h320M315.33 66v320M62 332.67h320M328.67 66v320M62 346h320M342 66v320M62 359.33h320M355.33 66v320M62 372.67h320M368.67 66v320" />
+      {{iconSVG}}
+    </g>
+    <text xml:space="preserve" fill="#ebebf5" fill-opacity=".8" font-family="Inter" font-size="32" letter-spacing="0em"
+      opacity=".79" style="white-space:pre">
+      <tspan x="434" y="293.64">See the icon preview, code examples,
+      </tspan>
+      <tspan x="434" y="341.64">release details and other related icons.</tspan>
+    </text>
+    <text xml:space="preserve" fill="#fff" font-family="Inter" font-size="44" font-weight="600" letter-spacing=".05em"
+      style="white-space:pre">
+      <tspan x="438" y="130.5">{{name}}</tspan>
+    </text>
+    <text xml:space="preserve" fill="#98989f" font-family="Inter" font-size="32" letter-spacing=".05em"
+      style="white-space:pre">
+      <tspan x="438" y="208.14">{{tags}}</tspan>
+    </text>
+    <path fill="#161618" d="M0 438h1200v192H0z" />
+    <path fill="#e7e7e7"
+      d="M395.33 562.28q-5.97 0-10.31-2.5a17 17 0 0 1-6.64-7.13q-2.32-4.64-2.32-10.92 0-6.17 2.32-10.83a17.7 17.7 0 0 1 6.56-7.3q4.2-2.62 9.9-2.62 3.66 0 6.92 1.2 3.28 1.17 5.78 3.64a17 17 0 0 1 3.98 6.3 26 26 0 0 1 1.45 9.07v2.89h-32.52v-6.36H404q-.03-2.7-1.17-4.81a8.5 8.5 0 0 0-3.17-3.36 9 9 0 0 0-4.7-1.23q-2.88 0-5.04 1.4a9.7 9.7 0 0 0-3.39 3.65q-1.19 2.25-1.21 4.93v5.54q0 3.5 1.27 6a9 9 0 0 0 3.53 3.8q2.29 1.3 5.32 1.3 2.05 0 3.7-.58a8 8 0 0 0 2.87-1.74 7 7 0 0 0 1.83-2.84l8.73 1a14 14 0 0 1-3.15 6.09 15.4 15.4 0 0 1-5.89 4q-3.6 1.41-8.21 1.41M346.67 562.2q-4.67 0-8.37-2.42a16.4 16.4 0 0 1-5.84-7.03q-2.14-4.6-2.14-11.2 0-6.67 2.17-11.25a16 16 0 0 1 5.91-6.95 15 15 0 0 1 8.3-2.37q3.48 0 5.73 1.2 2.25 1.17 3.56 2.84 1.32 1.63 2.05 3.1h.38v-19.95h9.38v53.33h-9.2v-6.3h-.56q-.74 1.45-2.1 3.1-1.37 1.61-3.61 2.76a12.4 12.4 0 0 1-5.66 1.14m2.6-7.73q2.99 0 5.07-1.62a10 10 0 0 0 3.18-4.55 19 19 0 0 0 1.08-6.8 19 19 0 0 0-1.08-6.74 9.6 9.6 0 0 0-3.15-4.46 8 8 0 0 0-5.1-1.59 8.2 8.2 0 0 0-5.2 1.64 10 10 0 0 0-3.16 4.54 19 19 0 0 0-1.06 6.61q0 3.75 1.06 6.7a10.5 10.5 0 0 0 3.18 4.6 8 8 0 0 0 5.19 1.67M312.98 561.5v-40h9.35v40zm4.7-45.68q-2.22 0-3.82-1.48a4.8 4.8 0 0 1-1.6-3.62q0-2.13 1.6-3.62a5.4 5.4 0 0 1 3.82-1.51q2.25 0 3.82 1.51 1.6 1.49 1.6 3.62a4.8 4.8 0 0 1-1.6 3.62 5.4 5.4 0 0 1-3.82 1.48M288.3 562.28q-5.93 0-10.2-2.63-4.23-2.62-6.53-7.26a24 24 0 0 1-2.27-10.73q0-6.1 2.32-10.76a17.4 17.4 0 0 1 6.56-7.29 19 19 0 0 1 10.07-2.63q4.83 0 8.56 1.8a14.6 14.6 0 0 1 5.96 5.02 15 15 0 0 1 2.53 7.55h-8.93a8.6 8.6 0 0 0-2.59-4.81q-2.01-1.95-5.4-1.96a8.4 8.4 0 0 0-5.03 1.57 10 10 0 0 0-3.39 4.42 18 18 0 0 0-1.19 6.93q0 4.1 1.2 7.03 1.19 2.93 3.33 4.5a8.5 8.5 0 0 0 5.08 1.57q2.07 0 3.7-.78a7.5 7.5 0 0 0 2.76-2.32q1.11-1.5 1.53-3.67h8.93a16 16 0 0 1-2.48 7.52 14.7 14.7 0 0 1-5.83 5.1 19.4 19.4 0 0 1-8.68 1.83M252.04 544.68V521.5h9.34v40h-9.06v-7.11h-.41a12 12 0 0 1-4.42 5.5q-3.05 2.13-7.52 2.13-3.9 0-6.9-1.74a12 12 0 0 1-4.64-5.13 18 18 0 0 1-1.68-8.18V521.5h9.35v24.01q0 3.8 2.06 6.04a7 7 0 0 0 5.43 2.24q2.07 0 4-1.01a8 8 0 0 0 3.18-3.02 9.4 9.4 0 0 0 1.26-5.08M185.96 561.5v-53.33h9.58v45.23h23.3v8.1zM117.1 534c0-7.6-6.1-13.75-13.64-13.75A13.7 13.7 0 0 0 89.82 534c0 17.72 14.25 32.08 31.83 32.08s31.82-14.36 31.82-32.08a50.5 50.5 0 0 0-16.67-37.58 4.6 4.6 0 0 1-.36-6.47 4.5 4.5 0 0 1 6.42-.36 59.7 59.7 0 0 1 19.7 44.4l-.05 2.13c-1.1 21.8-18.97 39.13-40.86 39.13-22.6 0-40.92-18.47-40.92-41.25a22.8 22.8 0 0 1 22.73-22.92A22.8 22.8 0 0 1 126.2 534a4.56 4.56 0 0 1-4.55 4.58 4.56 4.56 0 0 1-4.54-4.58" />
+    <path fill="#f56565"
+      d="M98.91 534a4.56 4.56 0 0 1 4.55-4.58 4.57 4.57 0 0 1 4.55 4.58c0 7.6 6.1 13.75 13.63 13.75 7.3 0 13.26-5.78 13.62-13.04l.02-.71c0-17.72-14.24-32.08-31.82-32.08S71.64 516.28 71.64 534a50.5 50.5 0 0 0 16.93 37.81 4.6 4.6 0 0 1 .4 6.48 4.53 4.53 0 0 1-6.42.4 59.7 59.7 0 0 1-19.98-43.03l-.02-1.66c0-22.78 18.31-41.25 40.91-41.25s40.92 18.47 40.92 41.25l-.04 1.18a22.8 22.8 0 0 1-22.7 21.74A22.8 22.8 0 0 1 98.92 534" />
+    <text xml:space="preserve" fill="#ebebf5" fill-opacity=".8" font-family="Inter" font-size="39" font-weight="500"
+      letter-spacing="0em" style="white-space:pre">
+      <tspan x="808.98" y="548.18">https://lucide.dev</tspan>
+    </text>
+    <path fill="url(#c)" d="M1116 0h84v435h-84z" />
+  </g>
+  <defs>
+    <clipPath id="a">
+      <path fill="#fff" d="M0 0h1200v630H0z" />
+    </clipPath>
+    <clipPath id="b">
+      <rect width="320" height="320" x="62" y="66" fill="#fff" rx="24" />
+    </clipPath>
+    <linearGradient id="c" x1="1200" x2="1116" y1="218" y2="218" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#1b1b1f" />
+      <stop offset="1" stop-color="#1b1b1f" stop-opacity="0" />
+    </linearGradient>
+  </defs>
+</svg>

docs/.vitepress/markdown/sandpack.ts

@@ -0,0 +1,138 @@
+import type MarkdownIt from 'markdown-it';
+import type { RenderRule } from 'markdown-it/lib/renderer.mjs';
+import container from 'markdown-it-container';
+import sandpackTheme from '../theme/sandpackTheme.json';
+
+type SnackParams = {
+  defaultFiles?: Record<
+    string,
+    {
+      code: string;
+      active?: boolean;
+      hidden?: boolean;
+    }
+  >;
+};
+
+type ContainerArgs = [typeof container, string, { render: RenderRule }];
+
+export default function sandpackPlugin(md: MarkdownIt, pluginOptions: SnackParams = {}) {
+  if (md == null) {
+    throw new Error('MarkdownIt instance is required for sandpackPlugin');
+  }
+  const escapeHtml = md?.utils?.escapeHtml;
+  const defaultFence =
+    md.renderer.rules.fence ||
+    ((tokens, idx, options, env, self) => self.renderToken(tokens, idx, options));
+
+  const renderSandbox = (tokenList: any[], index: number) => {
+    const renderFunc = (tokens: any[], idx: number) => {
+      if (tokens[idx].nesting === 1) {
+        const fileAttr: string[] = [];
+        const attrs = Object.fromEntries(tokens[idx].attrs || []);
+
+        const files: Record<
+          string,
+          {
+            code: string;
+            active?: boolean;
+            hidden?: boolean;
+          }
+        > = {};
+
+        for (
+          let i = idx + 1;
+          !(tokens[i].nesting === -1 && tokens[i].type === 'container_sandpack_close');
+          ++i
+        ) {
+          if (tokens[i].type === 'fence' && tokens[i].tag === 'code') {
+            const info = tokens[i].info ?? '';
+            const [lang, fileName, params = ''] = info.split(' ');
+
+            const active = params.includes('[active]');
+            const hidden = params.includes('[hidden]');
+
+            const code = tokens[i].content;
+
+            if (fileName && code) {
+              files[fileName] = {
+                code,
+              };
+
+              if (active) {
+                (files[fileName] as any).active = true;
+              }
+
+              if (hidden) {
+                (files[fileName] as any).hidden = true;
+              }
+            }
+          }
+        }
+
+        const { dependencies, showTabs, externalResources, editorWidthPercentage, ...options } =
+          attrs;
+
+        const dependencyList = dependencies?.split(',')?.map((dep: string) => dep.trim()) ?? [];
+
+        const dependencyObject = dependencyList.reduce(
+          (acc: Record<string, string>, name: string) => {
+            acc[name] = 'latest';
+            return acc;
+          },
+          {},
+        );
+
+        const externalResourcesList = externalResources
+          ?.split(',')
+          ?.map((res: string) => res.trim())
+          ?.filter((res: string) => res.length > 0);
+
+        const filesWithDefaultStyles = {
+          ...pluginOptions.defaultFiles,
+          ...files,
+        };
+
+        return `\
+        <Sandpack\
+          template="${escapeHtml(attrs.template || 'vanilla')}"\
+          :theme="${escapeHtml(JSON.stringify(sandpackTheme))}"\
+          :customSetup="${escapeHtml(
+            dependencyList
+              ? JSON.stringify({
+                  dependencies: dependencyList.length ? dependencyObject : {},
+                })
+              : undefined,
+          )}"
+          :files="${escapeHtml(JSON.stringify(filesWithDefaultStyles))}"\
+          :options="${escapeHtml(
+            JSON.stringify({
+              ...(showTabs ? { showTabs: JSON.parse(showTabs) } : {}),
+              externalResources: externalResourcesList,
+              editorWidthPercentage: editorWidthPercentage
+                ? Number(editorWidthPercentage)
+                : undefined,
+              ...options,
+            }),
+          )}"\
+        >`;
+      }
+      return `</Sandpack>`;
+    };
+    return renderFunc(tokenList, index);
+  };
+
+  function createCodeGroup(md: MarkdownIt): ContainerArgs {
+    return [
+      container,
+      'sandpack',
+      {
+        render(tokens, idx) {
+          return renderSandbox(tokens, idx);
+        },
+      },
+    ];
+  }
+
+  md.use(...createCodeGroup(md));
+}

docs/.vitepress/markdown/snackPlayer.ts

@@ -0,0 +1,99 @@
+/**
+ * SnackPlayer markdown-it plugin
+ *
+ * Converts fenced code blocks like:
+ *
+ * ```SnackPlayer name=My%20Example&description=Nice%20demo&ext=tsx
+ * // code here
+ * ```
+ *
+ * into:
+ *
+ * <div
+ *   class="snack-player"
+ *   data-snack-name="My Example"
+ *   ...
+ * />
+ */
+
+import type MarkdownIt from 'markdown-it';
+
+type SnackParams = Record<string, string>;
+
+function parseParams(paramString = ''): SnackParams {
+  const params = Object.fromEntries(new URLSearchParams(paramString)) as SnackParams;
+
+  if (!params.platform) {
+    params.platform = 'web';
+  }
+
+  return params;
+}
+
+export default function snackPlayerPlugin(md: MarkdownIt) {
+  const escapeHtml = md.utils.escapeHtml;
+  const defaultFence =
+    md.renderer.rules.fence ||
+    ((tokens, idx, options, env, self) => self.renderToken(tokens, idx, options));
+
+  md.renderer.rules.fence = (tokens, idx, options, env, self) => {
+    const token = tokens[idx];
+    const info = (token.info || '').trim();
+
+    if (!info) {
+      return defaultFence(tokens, idx, options, env, self);
+    }
+
+    const [lang, ...rest] = info.split(/\s+/);
+    if (lang !== 'SnackPlayer') {
+      return defaultFence(tokens, idx, options, env, self);
+    }
+
+    const paramString = rest.join(' ');
+    const params = parseParams(paramString);
+
+    // Gather necessary params
+    const name = params.name ? decodeURIComponent(params.name) : 'Example';
+    const description = params.description
+      ? decodeURIComponent(params.description)
+      : 'Example usage';
+    const ext = params.ext ? decodeURIComponent(params.ext) : 'tsx';
+    const filename = `App.${ext}`;
+
+    const files = encodeURIComponent(
+      JSON.stringify({
+        [filename]: {
+          type: 'CODE',
+          contents: token.content,
+        },
+      }),
+    );
+
+    const dependencies =
+      'react-native-safe-area-context' + (params.dependencies ? `,${params.dependencies}` : '');
+    const platform = params.platform ?? 'web';
+    const supportedPlatforms = params.supportedPlatforms ?? 'ios,android,web';
+    const theme = params.theme ?? 'light';
+    const preview = params.preview ?? 'true';
+    const loading = params.loading ?? 'lazy';
+    const deviceAppearance = params.deviceAppearance ?? 'dark';
+
+    // Build the HTML output (escaping where appropriate)
+    return (
+      `<SnackPlayer` +
+      ` class="snack-player"` +
+      ` data-snack-name="${escapeHtml(name)}"` +
+      ` data-snack-description="${escapeHtml(description)}"` +
+      ` data-snack-files="${files}"` +
+      ` data-snack-dependencies="${escapeHtml(dependencies)}"` +
+      ` data-snack-platform="${escapeHtml(platform)}"` +
+      ` data-snack-supported-platforms="${escapeHtml(supportedPlatforms)}"` +
+      // ` data-snack-theme="${escapeHtml(theme)}"` +
+      ` data-snack-preview="${escapeHtml(preview)}"` +
+      ` data-snack-loading="${escapeHtml(loading)}"` +
+      ` data-snack-device-appearance="${escapeHtml(deviceAppearance)}"` +
+      ` data-snack-device-frame="false"` +
+      `></SnackPlayer>`
+    );
+  };
+}

docs/.vitepress/sidebar.ts

@@ -1,139 +0,0 @@
-import { DefaultTheme, UserConfig } from 'vitepress';
-
-const sidebar: UserConfig<DefaultTheme.Config>['themeConfig']['sidebar'] = {
-  guide: [
-    {
-      text: 'Introduction',
-      items: [
-        { text: 'What is lucide?', link: '/guide/' },
-        { text: 'Installation', link: '/guide/installation' },
-        { text: 'Comparison', link: '/guide/comparison' },
-      ],
-    },
-    {
-      text: 'Basics',
-      items: [
-        {
-          text: 'Color',
-          link: '/guide/basics/color',
-        },
-        {
-          text: 'Sizing',
-          link: '/guide/basics/sizing',
-        },
-        {
-          text: 'Stroke width',
-          link: '/guide/basics/stroke-width',
-        },
-      ],
-    },
-    // TODO: Add this section
-    {
-      text: 'Advanced',
-      items: [
-        {
-          text: 'Accessibility',
-          link: '/guide/advanced/accessibility',
-        },
-        {
-          text: 'Global styling',
-          link: '/guide/advanced/global-styling',
-        },
-        // {
-        //   text: 'Animations',
-        // },
-        {
-          text: 'Filled icons',
-          link: '/guide/advanced/filled-icons',
-        },
-        {
-          text: 'Aliased Names',
-          link: '/guide/advanced/aliased-names',
-        },
-        // {
-        //   text: 'Combining icons',
-        // },
-        // {
-        //   text: 'Dynamic imports'
-        // },
-        // {
-        //   text: 'Auto importing'
-        // },
-      ],
-    },
-    {
-      text: 'Packages',
-      items: [
-        {
-          text: 'Lucide',
-          link: '/guide/packages/lucide',
-        },
-        {
-          text: 'Lucide React',
-          link: '/guide/packages/lucide-react',
-        },
-        {
-          text: 'Lucide Vue',
-          link: '/guide/packages/lucide-vue-next',
-        },
-        {
-          text: 'Lucide Svelte',
-          link: '/guide/packages/lucide-svelte',
-        },
-        {
-          text: 'Lucide Solid',
-          link: '/guide/packages/lucide-solid',
-        },
-        {
-          text: 'Lucide React Native',
-          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',
-        },
-      ],
-    },
-    {
-      text: 'Contributing',
-      items: [
-        {
-          text: 'Icon Design Principles',
-          link: '/guide/design/icon-design-guide',
-        },
-        {
-          text: 'Designing in Illustrator',
-          link: '/guide/design/illustrator-guide',
-        },
-        {
-          text: 'Designing in InkScape',
-          link: '/guide/design/inkscape-guide',
-        },
-        {
-          text: 'Designing in Figma',
-          link: '/guide/design/figma-guide',
-        },
-        {
-          text: 'Designing in Affinity Designer',
-          link: '/guide/design/affinity-designer-guide',
-        },
-      ],
-    },
-  ],
-  // This should be here to keep the sidebar shown on the icons page
-  icons: [{ text: '', link: '/' }],
-};
-
-export default sidebar;

docs/.vitepress/sidebar/angular.ts

@@ -0,0 +1,107 @@
+import { DefaultTheme } from 'vitepress';
+
+export const angularSidebar = [
+  {
+    items: [
+      {
+        text: 'Overview',
+        link: '/guide/angular/',
+      },
+      {
+        text: 'Getting started',
+        link: '/guide/angular/getting-started',
+        desc: 'Learn how to get started with Lucide for Angular.',
+      },
+      {
+        text: 'Migration from v0',
+        link: '/guide/angular/migration',
+        desc: 'Learn how to migrate from v0 to v1 of Lucide.',
+      },
+    ],
+  },
+  {
+    text: 'Basics',
+    items: [
+      {
+        text: 'Color',
+        desc: 'Adjust the color of your icons',
+        link: '/guide/angular/basics/color',
+      },
+      {
+        text: 'Sizing',
+        desc: 'Adjust the size of your icons',
+        link: '/guide/angular/basics/sizing',
+      },
+      {
+        text: 'Stroke width',
+        desc: 'Adjust the stroke width of your icons',
+        link: '/guide/angular/basics/stroke-width',
+      },
+    ],
+  },
+  {
+    text: 'Advanced',
+    items: [
+      {
+        text: 'Typescript',
+        link: '/guide/angular/advanced/typescript',
+        desc: 'All exported types and how to use them',
+      },
+      {
+        text: 'Accessibility',
+        link: '/guide/angular/advanced/accessibility',
+        desc: 'Making your icons accessible',
+      },
+      {
+        text: 'Global styling',
+        link: '/guide/angular/advanced/global-styling',
+        desc: 'Apply global styles to all icons',
+      },
+      {
+        text: 'With Lucide Lab',
+        link: '/guide/angular/advanced/with-lucide-lab',
+        desc: 'Using lucide-lab with @lucide/angular',
+      },
+      // {
+      //   text: 'Animations',
+      //   link: '/guide/angular/advanced/animations',
+      //   desc: 'Add animations to your icons',
+      // },
+      {
+        text: 'Filled icons',
+        link: '/guide/angular/advanced/filled-icons',
+        desc: 'Using filled icons in @lucide/angular',
+      },
+      {
+        text: 'Combining icons',
+        link: '/guide/angular/advanced/combining-icons',
+        desc: 'Combine multiple icons into one',
+      },
+      // {
+      //   text: 'Dynamic icon component',
+      //   link: '/guide/angular/advanced/dynamic-icon-component.md',
+      //   desc: 'Dynamically import icons as needed',
+      // },
+      {
+        text: 'Icon provider',
+        link: '/guide/angular/advanced/icon-provider',
+        desc: 'Provide icons at app level and use them by name',
+      },
+    ],
+  },
+  {
+    text: 'Resources',
+    items: [
+      {
+        text: 'Accessibility in depth',
+        link: '/guide/accessibility',
+        desc: 'Accessibility best practices',
+      },
+      {
+        text: 'VSCode',
+        link: '/guide/vscode',
+        desc: 'VSCode and Lucide',
+      },
+    ],
+  },
+] satisfies DefaultTheme.SidebarItem[] & { items: { desc?: string }[] }[];

docs/.vitepress/sidebar/astro.ts

@@ -0,0 +1,82 @@
+import { DefaultTheme } from 'vitepress';
+
+export const astroSidebar = [
+  {
+    items: [
+      {
+        text: 'Overview',
+        link: '/guide/astro/',
+      },
+      {
+        text: 'Getting started',
+        link: '/guide/astro/getting-started',
+        desc: 'Learn how to get started with Lucide for Astro.',
+      },
+      {
+        text: 'Migration from v0',
+        link: '/guide/astro/migration',
+        desc: 'Learn how to migrate from v0 to v1 of Lucide Astro.',
+      },
+    ],
+  },
+  {
+    text: 'Basics',
+    items: [
+      {
+        text: 'Color',
+        desc: 'Adjust the color of your icons',
+        link: '/guide/astro/basics/color',
+      },
+      {
+        text: 'Sizing',
+        desc: 'Adjust the size of your icons',
+        link: '/guide/astro/basics/sizing',
+      },
+      {
+        text: 'Stroke width',
+        desc: 'Adjust the stroke width of your icons',
+        link: '/guide/astro/basics/stroke-width',
+      },
+    ],
+  },
+  {
+    text: 'Advanced',
+    items: [
+      {
+        text: 'Typescript',
+        link: '/guide/astro/advanced/typescript',
+        desc: 'All exported types and how to use them',
+      },
+      {
+        text: 'Accessibility',
+        link: '/guide/astro/advanced/accessibility',
+        desc: 'Making your icons accessible',
+      },
+      {
+        text: 'Global styling',
+        link: '/guide/astro/advanced/global-styling',
+        desc: 'Apply global styles to all icons',
+      },
+      {
+        text: 'With Lucide Lab',
+        link: '/guide/astro/advanced/with-lucide-lab',
+        desc: 'Using lucide-lab with @lucide/astro',
+      },
+    ],
+  },
+  {
+    text: 'Resources',
+    items: [
+      {
+        text: 'Accessibility in depth',
+        link: '/guide/accessibility',
+        desc: 'Accessibility best practices',
+      },
+      {
+        text: 'VSCode',
+        link: '/guide/vscode',
+        desc: 'VSCode and Lucide',
+      },
+    ],
+  },
+] satisfies DefaultTheme.SidebarItem[] & { items: { desc?: string }[] }[];

docs/.vitepress/sidebar/index.ts

@@ -0,0 +1,48 @@
+import { DefaultTheme, UserConfig } from 'vitepress';
+import { reactSidebar } from './react';
+import { vueSidebar } from './vue';
+import { svelteSidebar } from './svelte';
+import { lucideSidebar } from './lucide';
+import { solidSidebar } from './solid';
+import { preactSidebar } from './preact';
+import { reactNativeSidebar } from './react-native';
+import { astroSidebar } from './astro';
+import { resourcesSidebar } from './resources';
+import { angularSidebar } from './angular';
+import { lucideStaticSidebar } from './static';
+
+type Sidebar = UserConfig<DefaultTheme.Config>['themeConfig']['sidebar'];
+
+export const guideSidebarTop: DefaultTheme.SidebarItem[] = [
+  {
+    text: 'Introduction',
+    items: [
+      { text: 'What is Lucide?', link: '/guide/' },
+      { text: 'Version 1', link: '/guide/version-1' },
+      { text: 'Installation', link: '/guide/installation' },
+    ],
+  },
+];
+
+const sidebar: Sidebar = {
+  '/guide': [{ text: '', link: '/' }],
+  '/guide/lucide/': lucideSidebar,
+  '/guide/react/': reactSidebar,
+  '/guide/vue/': vueSidebar,
+  '/guide/svelte/': svelteSidebar,
+  '/guide/solid/': solidSidebar,
+  '/guide/astro/': astroSidebar,
+  '/guide/preact/': preactSidebar,
+  '/guide/react-native/': reactNativeSidebar,
+  '/guide/angular/': angularSidebar,
+  '/guide/static/': lucideStaticSidebar,
+  '/community': resourcesSidebar,
+  '/contribute': resourcesSidebar,
+  '/license': resourcesSidebar,
+  '/code-of-conduct': resourcesSidebar,
+  '/brand-logo-statement': resourcesSidebar,
+  // This should be here to keep the sidebar shown on the icons page
+  icons: [{ text: '', link: '/' }],
+};
+
+export default sidebar;

docs/.vitepress/sidebar/lucide.ts

@@ -0,0 +1,87 @@
+import { DefaultTheme } from 'vitepress';
+
+export const lucideSidebar = [
+  {
+    items: [
+      {
+        text: 'Overview',
+        link: '/guide/lucide/',
+      },
+      {
+        text: 'Getting started',
+        link: '/guide/lucide/getting-started',
+        desc: 'Learn how to get started with Lucide.',
+      },
+      {
+        text: 'Migration from v0',
+        link: '/guide/lucide/migration',
+        desc: 'Learn how to migrate from v0 to v1 of Lucide.',
+      },
+    ],
+  },
+  {
+    text: 'Basics',
+    items: [
+      {
+        text: 'Color',
+        desc: 'Adjust the color of your icons',
+        link: '/guide/lucide/basics/color',
+      },
+      {
+        text: 'Sizing',
+        desc: 'Adjust the size of your icons',
+        link: '/guide/lucide/basics/sizing',
+      },
+      {
+        text: 'Stroke width',
+        desc: 'Adjust the stroke width of your icons',
+        link: '/guide/lucide/basics/stroke-width',
+      },
+    ],
+  },
+  {
+    text: 'Advanced',
+    items: [
+      {
+        text: 'Global styling',
+        link: '/guide/lucide/advanced/global-styling',
+        desc: 'Apply options and styles globally',
+      },
+      {
+        text: 'Shadow DOM',
+        link: '/guide/lucide/advanced/shadow-dom',
+        desc: 'All exported types and how to use them',
+      },
+      {
+        text: 'Template element',
+        link: '/guide/lucide/advanced/content-template-element',
+        desc: 'Using content template element with lucide',
+      },
+      {
+        text: 'Accessibility',
+        link: '/guide/lucide/advanced/accessibility',
+        desc: 'Making your icons accessible',
+      },
+      {
+        text: 'With Lucide Lab',
+        link: '/guide/lucide/advanced/with-lucide-lab',
+        desc: 'Using lucide-lab with lucide',
+      },
+      {
+        text: 'Filled icons',
+        link: '/guide/lucide/advanced/filled-icons',
+        desc: 'Using filled icons in lucide',
+      },
+    ],
+  },
+  {
+    text: 'Resources',
+    items: [
+      {
+        text: 'Accessibility in depth',
+        link: '/guide/accessibility',
+        desc: 'Accessibility best practices',
+      },
+    ],
+  },
+] satisfies DefaultTheme.SidebarItem[] & { items: { desc?: string }[] }[];

docs/.vitepress/sidebar/preact.ts

@@ -0,0 +1,102 @@
+import { DefaultTheme } from 'vitepress';
+
+export const preactSidebar = [
+  {
+    items: [
+      {
+        text: 'Overview',
+        link: '/guide/preact/',
+      },
+      {
+        text: 'Getting started',
+        link: '/guide/preact/getting-started',
+        desc: 'Learn how to get started with Lucide for PReact.',
+      },
+      {
+        text: 'Migration from v0',
+        link: '/guide/preact/migration',
+        desc: 'Learn how to migrate from v0 to v1 of Lucide.',
+      },
+    ],
+  },
+  {
+    text: 'Basics',
+    items: [
+      {
+        text: 'Color',
+        desc: 'Adjust the color of your icons',
+        link: '/guide/preact/basics/color',
+      },
+      {
+        text: 'Sizing',
+        desc: 'Adjust the size of your icons',
+        link: '/guide/preact/basics/sizing',
+      },
+      {
+        text: 'Stroke width',
+        desc: 'Adjust the stroke width of your icons',
+        link: '/guide/preact/basics/stroke-width',
+      },
+    ],
+  },
+  {
+    text: 'Advanced',
+    items: [
+      {
+        text: 'Typescript',
+        link: '/guide/preact/advanced/typescript',
+        desc: 'All exported types and how to use them',
+      },
+      {
+        text: 'Accessibility',
+        link: '/guide/preact/advanced/accessibility',
+        desc: 'Making your icons accessible',
+      },
+      {
+        text: 'Global styling',
+        link: '/guide/preact/advanced/global-styling',
+        desc: 'Apply global styles to all icons',
+      },
+      {
+        text: 'With Lucide Lab',
+        link: '/guide/preact/advanced/with-lucide-lab',
+        desc: 'Using lucide-lab with lucide-preact',
+      },
+      // {
+      //   text: 'Animations',
+      //   link: '/guide/preact/advanced/animations',
+      //   desc: 'Add animations to your icons',
+      // },
+      {
+        text: 'Filled icons',
+        link: '/guide/preact/advanced/filled-icons',
+        desc: 'Using filled icons in lucide-preact',
+      },
+      {
+        text: 'Aliased Names',
+        link: '/guide/preact/advanced/aliased-names',
+        desc: 'Using aliased icon names',
+      },
+      {
+        text: 'Combining icons',
+        link: '/guide/preact/advanced/combining-icons',
+        desc: 'Combine multiple icons into one',
+      },
+    ],
+  },
+  {
+    text: 'Resources',
+    items: [
+      {
+        text: 'Accessibility in depth',
+        link: '/guide/accessibility',
+        desc: 'Accessibility best practices',
+      },
+      {
+        text: 'VSCode',
+        link: '/guide/vscode',
+        desc: 'VSCode and Lucide',
+      },
+    ],
+  },
+] satisfies DefaultTheme.SidebarItem[] & { items: { desc?: string }[] }[];

docs/.vitepress/sidebar/react-native.ts

@@ -0,0 +1,87 @@
+import { DefaultTheme } from 'vitepress';
+
+export const reactNativeSidebar = [
+  {
+    items: [
+      {
+        text: 'Overview',
+        link: '/guide/react-native/',
+      },
+      {
+        text: 'Getting started',
+        link: '/guide/react-native/getting-started',
+        desc: 'Learn how to get started with Lucide React Native',
+      },
+      {
+        text: 'Migration from v0',
+        link: '/guide/react-native/migration',
+        desc: 'Learn how to migrate from v0 to v1 of Lucide.',
+      },
+    ],
+  },
+  {
+    text: 'Basics',
+    items: [
+      {
+        text: 'Color',
+        desc: 'Adjust the color of your icons',
+        link: '/guide/react-native/basics/color',
+      },
+      {
+        text: 'Sizing',
+        desc: 'Adjust the size of your icons',
+        link: '/guide/react-native/basics/sizing',
+      },
+      {
+        text: 'Stroke width',
+        desc: 'Adjust the stroke width of your icons',
+        link: '/guide/react-native/basics/stroke-width',
+      },
+    ],
+  },
+  {
+    text: 'Advanced',
+    items: [
+      {
+        text: 'Typescript',
+        link: '/guide/react-native/advanced/typescript',
+        desc: 'All exported types and how to use them',
+      },
+      {
+        text: 'Global styling',
+        link: '/guide/react-native/advanced/global-styling',
+        desc: 'Apply global styles to all icons',
+      },
+      {
+        text: 'With Lucide Lab',
+        link: '/guide/react-native/advanced/with-lucide-lab',
+        desc: 'Using lucide-lab with lucide-react-native',
+      },
+      {
+        text: 'Filled icons',
+        link: '/guide/react-native/advanced/filled-icons',
+        desc: 'Using filled icons in lucide-react-native',
+      },
+      {
+        text: 'Aliased Names',
+        link: '/guide/react-native/advanced/aliased-names',
+        desc: 'Using aliased icon names',
+      },
+      {
+        text: 'Combining icons',
+        link: '/guide/react-native/advanced/combining-icons',
+        desc: 'Combine multiple icons into one',
+      },
+    ],
+  },
+  {
+    text: 'Resources',
+    items: [
+      {
+        text: 'VSCode',
+        link: '/guide/vscode',
+        desc: 'VSCode and Lucide',
+      },
+    ],
+  },
+] satisfies DefaultTheme.SidebarItem[] & { items: { desc?: string }[] }[];

docs/.vitepress/sidebar/react.ts

@@ -0,0 +1,113 @@
+import { DefaultTheme } from 'vitepress';
+
+export const reactSidebar = [
+  {
+    items: [
+      {
+        text: 'Overview',
+        link: '/guide/react/',
+      },
+      {
+        text: 'Getting started',
+        link: '/guide/react/getting-started',
+        desc: 'Learn how to get started with Lucide for React.',
+      },
+      {
+        text: 'Migration from v0',
+        link: '/guide/react/migration',
+        desc: 'Learn how to migrate from v0 to v1 of Lucide.',
+      },
+      {
+        text: 'Migration from React Feather',
+        link: '/guide/react/migration-from-feather',
+        desc: 'Learn how to migrate from `react-feather` to `lucide-react`',
+      },
+    ],
+  },
+  {
+    text: 'Basics',
+    items: [
+      {
+        text: 'Color',
+        desc: 'Adjust the color of your icons',
+        link: '/guide/react/basics/color',
+      },
+      {
+        text: 'Sizing',
+        desc: 'Adjust the size of your icons',
+        link: '/guide/react/basics/sizing',
+      },
+      {
+        text: 'Stroke width',
+        desc: 'Adjust the stroke width of your icons',
+        link: '/guide/react/basics/stroke-width',
+      },
+    ],
+  },
+  {
+    text: 'Advanced',
+    items: [
+      {
+        text: 'Typescript',
+        link: '/guide/react/advanced/typescript',
+        desc: 'All exported types and how to use them',
+      },
+      {
+        text: 'Accessibility',
+        link: '/guide/react/advanced/accessibility',
+        desc: 'Making your icons accessible',
+      },
+      {
+        text: 'Global styling',
+        link: '/guide/react/advanced/global-styling',
+        desc: 'Apply global styles to all icons',
+      },
+      {
+        text: 'With Lucide Lab',
+        link: '/guide/react/advanced/with-lucide-lab',
+        desc: 'Using lucide-lab with lucide-react',
+      },
+      // {
+      //   text: 'Animations',
+      //   link: '/guide/react/advanced/animations',
+      //   desc: 'Add animations to your icons',
+      // },
+      {
+        text: 'Filled icons',
+        link: '/guide/react/advanced/filled-icons',
+        desc: 'Using filled icons in lucide-react',
+      },
+      {
+        text: 'Aliased Names',
+        link: '/guide/react/advanced/aliased-names',
+        desc: 'Using aliased icon names',
+      },
+
+      {
+        text: 'Combining icons',
+        link: '/guide/react/advanced/combining-icons',
+        desc: 'Combine multiple icons into one',
+      },
+      {
+        text: 'Dynamic icon component',
+        link: '/guide/react/advanced/dynamic-icon-component.md',
+        desc: 'Dynamically import icons as needed',
+      },
+    ],
+  },
+  {
+    text: 'Resources',
+    items: [
+      {
+        text: 'Accessibility in depth',
+        link: '/guide/accessibility',
+        desc: 'Accessibility best practices',
+      },
+      {
+        text: 'VSCode',
+        link: '/guide/vscode',
+        desc: 'VSCode and Lucide',
+      },
+    ],
+  },
+] satisfies DefaultTheme.SidebarItem[] & { items: { desc?: string }[] }[];

docs/.vitepress/sidebar/resources.ts

@@ -0,0 +1,52 @@
+export const resourcesSidebar = [
+  {
+    text: 'About',
+    items: [
+      {
+        text: 'License',
+        link: '/license',
+      },
+      {
+        text: 'Community',
+        link: '/community',
+      },
+      {
+        text: 'Code of Conduct',
+        link: '/code-of-conduct',
+      },
+      {
+        text: 'Brand logo statement',
+        link: '/brand-logo-statement',
+      },
+      {
+        text: 'Contributing',
+        link: '/contribute',
+      },
+    ],
+  },
+  {
+    text: 'Designing icons',
+    items: [
+      {
+        text: 'Icon Design Principles',
+        link: '/contribute/icon-design-guide',
+      },
+      {
+        text: 'Designing in Illustrator',
+        link: '/contribute/illustrator-guide',
+      },
+      {
+        text: 'Designing in Inkscape',
+        link: '/contribute/inkscape-guide',
+      },
+      {
+        text: 'Designing in Figma',
+        link: '/contribute/figma-guide',
+      },
+      {
+        text: 'Designing in Affinity Designer',
+        link: '/contribute/affinity-designer-guide',
+      },
+    ],
+  },
+];

docs/.vitepress/sidebar/solid.ts

@@ -0,0 +1,103 @@
+import { DefaultTheme } from 'vitepress';
+
+export const solidSidebar = [
+  {
+    items: [
+      {
+        text: 'Overview',
+        link: '/guide/solid/',
+      },
+      {
+        text: 'Getting started',
+        link: '/guide/solid/getting-started',
+        desc: 'Learn how to get started with Lucide.',
+      },
+      {
+        text: 'Migration from v0',
+        link: '/guide/solid/migration',
+        desc: 'Learn how to migrate from v0 to v1 of Lucide.',
+      },
+    ],
+  },
+  {
+    text: 'Basics',
+    items: [
+      {
+        text: 'Color',
+        desc: 'Adjust the color of your icons',
+        link: '/guide/solid/basics/color',
+      },
+      {
+        text: 'Sizing',
+        desc: 'Adjust the size of your icons',
+        link: '/guide/solid/basics/sizing',
+      },
+      {
+        text: 'Stroke width',
+        desc: 'Adjust the stroke width of your icons',
+        link: '/guide/solid/basics/stroke-width',
+      },
+    ],
+  },
+  {
+    text: 'Advanced',
+    items: [
+      {
+        text: 'Typescript',
+        link: '/guide/solid/advanced/typescript',
+        desc: 'All exported types and how to use them',
+      },
+      {
+        text: 'Accessibility',
+        link: '/guide/solid/advanced/accessibility',
+        desc: 'Making your icons accessible',
+      },
+      {
+        text: 'Global styling',
+        link: '/guide/solid/advanced/global-styling',
+        desc: 'Apply global styles to all icons',
+      },
+      {
+        text: 'With Lucide Lab',
+        link: '/guide/solid/advanced/with-lucide-lab',
+        desc: 'Using lucide-lab with lucide-solid',
+      },
+      // {
+      //   text: 'Animations',
+      //   link: '/guide/solid/advanced/animations',
+      //   desc: 'Add animations to your icons',
+      // },
+      {
+        text: 'Filled icons',
+        link: '/guide/solid/advanced/filled-icons',
+        desc: 'Using filled icons in lucide-solid',
+      },
+      {
+        text: 'Aliased Names',
+        link: '/guide/solid/advanced/aliased-names',
+        desc: 'Using aliased icon names',
+      },
+      // Add support for this later
+      // {
+      //   text: 'Combining icons',
+      //   link: '/guide/solid/advanced/combining-icons',
+      //   desc: 'Combine multiple icons into one',
+      // },
+    ],
+  },
+  {
+    text: 'Resources',
+    items: [
+      {
+        text: 'Accessibility in depth',
+        link: '/guide/accessibility',
+        desc: 'Accessibility best practices',
+      },
+      {
+        text: 'VSCode',
+        link: '/guide/vscode',
+        desc: 'VSCode and Lucide',
+      },
+    ],
+  },
+] satisfies DefaultTheme.SidebarItem[] & { items: { desc?: string }[] }[];

docs/.vitepress/sidebar/static.ts

@@ -0,0 +1,88 @@
+import { DefaultTheme } from 'vitepress';
+
+export const lucideStaticSidebar = [
+  {
+    items: [
+      {
+        text: 'Overview',
+        desc: 'Overview of using Lucide icons as static assets in your projects',
+        link: '/guide/static/',
+      },
+      {
+        text: 'Getting started',
+        link: '/guide/static/getting-started',
+        desc: 'Learn how to get started with Lucide static.',
+      },
+      {
+        text: 'Migration from v0',
+        link: '/guide/static/migration',
+        desc: 'Learn how to migrate from v0 to v1 of Lucide static.',
+      },
+    ],
+  },
+  {
+    text: 'SVG Files & Sprite',
+    items: [
+      {
+        text: 'Import SVG files as images',
+        desc: 'Use icons as images in your project',
+        link: '/guide/static/link-as-image',
+      },
+      {
+        text: 'SVG Sprite',
+        desc: 'Use SVG sprites in your project',
+        link: '/guide/static/svg-sprite',
+      },
+    ],
+  },
+  {
+    text: 'Icon Font',
+    items: [
+      {
+        text: 'Import as font',
+        desc: 'Use icons as a web font in your project',
+        link: '/guide/static/font/',
+      },
+      {
+        text: 'Color',
+        desc: 'Adjust the color of your icons',
+        link: '/guide/static/font/color',
+      },
+      {
+        text: 'Sizing',
+        desc: 'Adjust the size of your icons',
+        link: '/guide/static/font/sizing',
+      },
+    ],
+  },
+  {
+    text: 'SVG String JS modules',
+    items: [
+      {
+        text: 'Use in Node.js',
+        desc: 'Use Lucide in your Node.js projects',
+        link: '/guide/static/js-modules/node',
+      },
+      {
+        text: 'Use in JS projects',
+        desc: 'Use Lucide in your JavaScript projects',
+        link: '/guide/static/js-modules/web',
+      },
+    ],
+  },
+  {
+    text: 'Resources',
+    items: [
+      {
+        text: 'Accessibility in depth',
+        link: '/guide/accessibility',
+        desc: 'Accessibility best practices',
+      },
+      {
+        text: 'VSCode',
+        link: '/guide/vscode',
+        desc: 'VSCode and Lucide',
+      },
+    ],
+  },
+] satisfies DefaultTheme.SidebarItem[] & { items: { desc?: string }[] }[];

docs/.vitepress/sidebar/svelte.ts

@@ -0,0 +1,92 @@
+import { DefaultTheme } from 'vitepress';
+
+export const svelteSidebar = [
+  {
+    items: [
+      {
+        text: 'Overview',
+        link: '/guide/svelte/',
+      },
+      {
+        text: 'Getting started',
+        link: '/guide/svelte/getting-started',
+        desc: 'Learn how to get started with Lucide for Svelte.',
+      },
+      {
+        text: 'Migration from v0',
+        link: '/guide/svelte/migration',
+        desc: 'Learn how to migrate from v0 to v1 of Lucide.',
+      },
+    ],
+  },
+  {
+    text: 'Basics',
+    items: [
+      {
+        text: 'Color',
+        desc: 'Adjust the color of your icons',
+        link: '/guide/svelte/basics/color',
+      },
+      {
+        text: 'Sizing',
+        desc: 'Adjust the size of your icons',
+        link: '/guide/svelte/basics/sizing',
+      },
+      {
+        text: 'Stroke width',
+        desc: 'Adjust the stroke width of your icons',
+        link: '/guide/svelte/basics/stroke-width',
+      },
+    ],
+  },
+  {
+    text: 'Advanced',
+    items: [
+      {
+        text: 'Typescript',
+        link: '/guide/svelte/advanced/typescript',
+        desc: 'All exported types and how to use them',
+      },
+      {
+        text: 'Accessibility',
+        link: '/guide/svelte/advanced/accessibility',
+        desc: 'Making your icons accessible',
+      },
+      {
+        text: 'Global styling',
+        link: '/guide/svelte/advanced/global-styling',
+        desc: 'Apply global styles to all icons',
+      },
+      {
+        text: 'With Lucide Lab',
+        link: '/guide/svelte/advanced/with-lucide-lab',
+        desc: 'Using lucide-lab with @lucide/svelte',
+      },
+      {
+        text: 'Filled icons',
+        link: '/guide/svelte/advanced/filled-icons',
+        desc: 'Using filled icons in @lucide/svelte',
+      },
+      {
+        text: 'Combining icons',
+        link: '/guide/svelte/advanced/combining-icons',
+        desc: 'Combine multiple icons into one',
+      },
+    ],
+  },
+  {
+    text: 'Resources',
+    items: [
+      {
+        text: 'Accessibility in depth',
+        link: '/guide/accessibility',
+        desc: 'Accessibility best practices',
+      },
+      {
+        text: 'VSCode',
+        link: '/guide/vscode',
+        desc: 'VSCode and Lucide',
+      },
+    ],
+  },
+] satisfies DefaultTheme.SidebarItem[] & { items: { desc?: string }[] }[];

docs/.vitepress/sidebar/vue.ts

@@ -0,0 +1,98 @@
+import { DefaultTheme } from 'vitepress';
+
+export const vueSidebar = [
+  {
+    items: [
+      {
+        text: 'Overview',
+        link: '/guide/vue/',
+      },
+      {
+        text: 'Getting started',
+        link: '/guide/vue/getting-started',
+        desc: 'Learn how to get started with Lucide for Vue.',
+      },
+      {
+        text: 'Migration from v0',
+        link: '/guide/vue/migration',
+        desc: 'Learn how to migrate from v0 to v1 of Lucide.',
+      },
+    ],
+  },
+  {
+    text: 'Basics',
+    items: [
+      {
+        text: 'Color',
+        desc: 'Adjust the color of your icons',
+        link: '/guide/vue/basics/color',
+      },
+      {
+        text: 'Sizing',
+        desc: 'Adjust the size of your icons',
+        link: '/guide/vue/basics/sizing',
+      },
+      {
+        text: 'Stroke width',
+        desc: 'Adjust the stroke width of your icons',
+        link: '/guide/vue/basics/stroke-width',
+      },
+    ],
+  },
+  {
+    text: 'Advanced',
+    items: [
+      {
+        text: 'Typescript',
+        link: '/guide/vue/advanced/typescript',
+        desc: 'All exported types and how to use them',
+      },
+      {
+        text: 'Accessibility',
+        link: '/guide/vue/advanced/accessibility',
+        desc: 'Making your icons accessible',
+      },
+      {
+        text: 'Global styling',
+        link: '/guide/vue/advanced/global-styling',
+        desc: 'Apply global styles to all icons',
+      },
+      {
+        text: 'With Lucide Lab',
+        link: '/guide/vue/advanced/with-lucide-lab',
+        desc: 'Using lucide-lab with @lucide/vue',
+      },
+      {
+        text: 'Filled icons',
+        link: '/guide/vue/advanced/filled-icons',
+        desc: 'Using filled icons in @lucide/vue',
+      },
+      {
+        text: 'Aliased Names',
+        link: '/guide/vue/advanced/aliased-names',
+        desc: 'Using aliased icon names',
+      },
+
+      {
+        text: 'Combining icons',
+        link: '/guide/vue/advanced/combining-icons',
+        desc: 'Combine multiple icons into one',
+      },
+    ],
+  },
+  {
+    text: 'Resources',
+    items: [
+      {
+        text: 'Accessibility in depth',
+        link: '/guide/accessibility',
+        desc: 'Accessibility best practices',
+      },
+      {
+        text: 'VSCode',
+        link: '/guide/vscode',
+        desc: 'VSCode and Lucide',
+      },
+    ],
+  },
+] satisfies DefaultTheme.SidebarItem[] & { items: { desc?: string }[] }[];

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

@@ -1,62 +1,58 @@
 <script setup lang="ts">
-import VPButton from 'vitepress/dist/client/theme-default/components/VPButton.vue'
-import { computed, ref } from 'vue'
-import {
-  Listbox,
-  ListboxButton,
-  ListboxOptions,
-  ListboxOption,
-} from '@headlessui/vue'
-import createLucideIcon from 'lucide-vue-next/src/createLucideIcon'
-import { chevronUp }  from '../../../data/iconNodes'
-import { useStorage } from '@vueuse/core'
+import VPButton from 'vitepress/dist/client/theme-default/components/VPButton.vue';
+import { computed, ref } from 'vue';
+import { Listbox, ListboxButton, ListboxOptions, ListboxOption } from '@headlessui/vue';
+import createLucideIcon from '@lucide/vue/src/createLucideIcon';
+import { chevronUp } from '../../../data/iconNodes';
+import { useStorage } from '@vueuse/core';
 
 interface Props {
   options: {
-    text: string
-    onClick?: () => void
-  }[],
-  callOptionOnClick?: boolean
-  buttonClass?: string
-  id: string
-  popoverPosition?: 'top' | 'bottom'
+    text: string;
+    onClick?: () => void;
+  }[];
+  callOptionOnClick?: boolean;
+  buttonClass?: string;
+  id: string;
+  popoverPosition?: 'top' | 'bottom';
 }
 
 const props = withDefaults(defineProps<Props>(), {
   callOptionOnClick: false,
-  popoverPosition: 'bottom'
-})
+  popoverPosition: 'bottom',
+});
 
-const emit = defineEmits(['click', 'optionClick'])
+const emit = defineEmits(['click', 'optionClick']);
 
-const buttonRef = ref(null)
+const buttonRef = ref(null);
 
-const selectedOption = useStorage(props.id, props.options[0].text)
-const selectionOptionAction = computed(() => props.options.find(option => option.text === selectedOption.value).onClick)
+const selectedOption = useStorage(props.id, props.options[0].text);
+const selectionOptionAction = computed(
+  () => props.options.find((option) => option.text === selectedOption.value).onClick,
+);
 
 function onClick(event) {
-  selectionOptionAction.value()
+  selectionOptionAction.value();
 
-
-  emit('click', event)
+  emit('click', event);
 }
 
 function onOptionClick(event, option) {
-  if(!props.callOptionOnClick) {
-    return
+  if (!props.callOptionOnClick) {
+    return;
   }
 
-  option.onClick()
+  option.onClick();
 
-  emit('optionClick', event)
+  emit('optionClick', event);
 }
 
-const ChevronUp = createLucideIcon('ChevronUp', chevronUp)
+const ChevronUp = createLucideIcon('ChevronUp', chevronUp);
 </script>
 
 <template>
   <Listbox v-model="selectedOption">
-    <div class="menu" >
+    <div class="menu">
       <div class="button-wrapper">
         <VPButton
           v-bind="$attrs"
@@ -75,7 +71,10 @@ const ChevronUp = createLucideIcon('ChevronUp', chevronUp)
           :class="popoverPosition"
         />
       </div>
-      <ListboxOptions class="menu-items" :class="popoverPosition">
+      <ListboxOptions
+        class="menu-items"
+        :class="popoverPosition"
+      >
         <ListboxOption
           as="button"
           class="menu-item"
@@ -122,7 +121,9 @@ ul.menu-items {
   font-weight: 500;
   color: var(--vp-c-text-1);
   white-space: nowrap;
-  transition: background-color .25s,color .25s;
+  transition:
+    background-color 0.25s,
+    color 0.25s;
   list-style: none;
 }
 

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

@@ -1,23 +1,31 @@
 <script setup lang="ts">
+import { useData } from 'vitepress';
 import { computed } from 'vue';
 
 const props = defineProps<{
-  modelValue: string
-  id: string
-}>()
+  modelValue: string;
+  id: string;
+}>();
 
-const emit = defineEmits(['update:modelValue'])
+const { isDark } = useData();
+
+const emit = defineEmits(['update:modelValue']);
 
 const value = computed({
-  get: () => props.modelValue,
-  set: (val) => emit('update:modelValue', val)
-})
+  get: () => {
+    if (props.modelValue == null || props.modelValue === 'currentColor') {
+      return isDark.value ? '#ffffff' : '#000000';
+    }
+
+    return props.modelValue;
+  },
+  set: (val) => emit('update:modelValue', val),
+});
 </script>
 
 <template>
   <div class="color-picker">
     <div class="color-input-wrapper">
-      <!-- TODO: Add currentColor div if value is currentColor -->
       <input
         type="color"
         :id="id"
@@ -33,6 +41,7 @@ const value = computed({
       class="color-input-text"
       aria-label="Color picker input"
       v-model="value"
+      placeholder="[default]"
     />
   </div>
 </template>
@@ -45,27 +54,33 @@ const value = computed({
   top: -5px;
   left: -5px;
 }
+
 .color-input-wrapper {
   height: 24px;
   width: 24px;
   overflow: hidden;
   position: relative;
-  border-radius: 12px;
+  border-radius: 4px;
   flex-shrink: 0;
 }
+
 .color-picker {
   background: var(--color-picker-bg, var(--vp-c-bg-alt));
   border-radius: 8px;
   color: var(--vp-c-text-2);
-  padding: 4px 8px;
+  padding: 3px 8px 3px 3px;
   height: auto;
-  font-size: 14px;
+  font-size: 13px;
   text-align: left;
   border: 1px solid transparent;
   cursor: text;
   display: flex;
   align-items: center;
   gap: 2px;
+  transition:
+    color 0.25s,
+    border-color 0.25s,
+    background-color 0.25s;
 }
 
 .color-input-text {
@@ -75,19 +90,24 @@ const value = computed({
   border: none;
   background: transparent;
   color: var(--vp-c-text-1);
-  font-size: 14px;
+  font-size: 13px;
   text-align: left;
   border-radius: 8px;
   cursor: text;
-  transition: border-color 0.25s, background 0.4s ease;
+  transition:
+    border-color 0.25s,
+    background 0.4s ease;
+  letter-spacing: 1px;
 }
 
-.color-picker:hover, .color-picker:focus {
+.color-picker:hover,
+.color-picker:focus-within {
   border-color: var(--vp-c-brand);
-  background: var(--vp-c-bg-alt);
+}
+.color-picker:focus-within {
+  background-color: var(--vp-c-bg);
 }
 
-.color-input[value="currentColor"] {
-
+.color-input[value='currentColor'] {
 }
 </style>

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

@@ -1,14 +1,27 @@
 <script setup>
-import createLucideIcon from 'lucide-vue-next/src/createLucideIcon'
-import { search }  from '../../../data/iconNodes'
+import Icon from '@lucide/vue/src/Icon';
+import { search } from '../../../data/iconNodes';
 
-const SearchIcon = createLucideIcon('search', search)
+defineProps({
+  shortcut: {
+    type: String,
+    required: false,
+  },
+});
 </script>
 
 <template>
   <button class="fake-input">
-    <component :is="SearchIcon" class="search-icon"/>
-    <slot/>
+    <Icon
+      :iconNode="search"
+      class="search-icon"
+    />
+    <slot />
+    <kbd
+      v-if="shortcut"
+      class="shortcut"
+      >{{ shortcut }}</kbd
+    >
   </button>
 </template>
 
@@ -26,11 +39,33 @@ const SearchIcon = createLucideIcon('search', search)
   cursor: text;
   display: flex;
   gap: 12px;
-  transition: color 0.25s, border-color 0.25s, background-color 0.25s;
+  transition:
+    color 0.25s,
+    border-color 0.25s,
+    background-color 0.25s;
 }
 
-.fake-input:hover, .fake-input:focus {
+.fake-input:hover,
+.fake-input:focus {
   border-color: var(--vp-c-brand);
-  background: var(--vp-c-bg-alt);
+}
+
+.shortcut {
+  margin-left: auto;
+  padding: 2px 6px;
+  font-size: 12px;
+  font-family: inherit;
+  font-weight: 500;
+  line-height: 1.5;
+  color: var(--vp-c-text-3);
+  background: var(--vp-c-default-soft);
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 4px;
+}
+
+@media (hover: none) {
+  .shortcut {
+    display: none;
+  }
 }
 </style>

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

@@ -5,7 +5,6 @@
 </template>
 
 <style scoped>
-
 .icon-button {
   display: inline-flex;
   border: 1px solid transparent;
@@ -30,9 +29,9 @@
 }
 
 .icon-button:active {
-    border-color: var(--vp-button-alt-active-border);
-    color: var(--vp-button-alt-active-text);
-    background-color: var(--vp-button-alt-active-bg);
+  border-color: var(--vp-button-alt-active-border);
+  color: var(--vp-button-alt-active-text);
+  background-color: var(--vp-button-alt-active-bg);
 }
 
 .icon-button.active {

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

@@ -1,44 +1,93 @@
 <script lang="ts">
 export default {
   inheritAttrs: false,
-}
+};
 
 export interface InputProps {
-  type: string
-  modelValue: string
+  type: string;
+  modelValue: string;
+  shortcut?: string;
 }
 </script>
 
 <script setup lang="ts">
-import { ref } from 'vue'
+import { ref, onMounted, nextTick, watch } from 'vue';
+import Icon from '@lucide/vue/src/Icon';
+import { x } from '../../../data/iconNodes';
+import IconButton from './IconButton.vue';
 
 const props = withDefaults(defineProps<InputProps>(), {
-  type: 'text'
-})
+  type: 'text',
+});
 
-const input = ref()
+const input = ref();
+const wrapperEl = ref();
+const shortcutEl = ref();
 
-defineEmits(['change', 'input', 'update:modelValue'])
+const emit = defineEmits(['change', 'input', 'update:modelValue']);
+
+const updateShortcutSpacing = () => {
+  nextTick(() => {
+    if (shortcutEl.value && wrapperEl.value) {
+      const shortcutWidth = shortcutEl.value.offsetWidth;
+      wrapperEl.value.style.setProperty('--shortcut-width', `${shortcutWidth}px`);
+    }
+  });
+};
+
+const isMac = /(Mac|iPhone|iPod|iPad)/i.test(navigator.platform);
+
+onMounted(updateShortcutSpacing);
+watch(() => props.shortcut, updateShortcutSpacing);
+
+function onClear() {
+  emit('update:modelValue', '');
+  input.value.focus();
+}
 
 defineExpose({
   focus: () => {
-    input.value.focus()
-  }
-})
+    input.value.focus();
+  },
+});
 </script>
 
 <template>
-  <div class="input-wrapper">
-    <slot name="icon" class="icon" />
+  <div
+    class="input-wrapper"
+    ref="wrapperEl"
+  >
+    <slot
+      name="icon"
+      class="icon"
+    />
     <input
       :type="type"
       class="input"
-      :class="{'has-icon': $slots.icon}"
+      :class="{ 'has-icon': $slots.icon, 'has-shortcut': shortcut }"
       ref="input"
       :value="modelValue"
       v-bind="$attrs"
       @input="$emit('update:modelValue', $event.target.value)"
     />
+    <IconButton
+      @click="onClear"
+      v-if="type === 'search' && modelValue"
+      class="clear-button"
+      aria-label="Clear input"
+      :style="{ right: isMac ? '50px' : '68px' }"
+    >
+      <Icon
+        :iconNode="x"
+        :size="20"
+      />
+    </IconButton>
+    <kbd
+      v-if="shortcut"
+      class="shortcut"
+      ref="shortcutEl"
+      >{{ shortcut }}</kbd
+    >
   </div>
 </template>
 
@@ -46,6 +95,7 @@ defineExpose({
 .input-wrapper {
   position: relative;
 }
+
 .input {
   justify-content: flex-start;
   border: 1px solid transparent;
@@ -55,22 +105,84 @@ defineExpose({
   height: 40px;
   background-color: var(--vp-c-bg-alt);
   font-size: 14px;
+  transition:
+    color 0.25s,
+    border-color 0.25s,
+    background-color 0.25s;
 }
 
-.input:hover, .input:focus {
+.input.has-shortcut {
+  padding-right: calc(var(--shortcut-width, 40px) + 22px);
+}
+
+.input:hover,
+.input:focus {
   border-color: var(--vp-c-brand);
-  background: var(--vp-c-bg-alt);
+}
+.input:focus {
+  background-color: var(--vp-c-bg);
 }
 
 .input.has-icon {
   padding-left: 52px;
 }
 
+.clear-button {
+  position: absolute;
+  right: 68px;
+  top: 9px;
+  padding: 4px;
+  transition: background-color 0.25s;
+}
 
+.shortcut {
+  position: absolute;
+  right: 12px;
+  top: 50%;
+  transform: translateY(-50%);
+  padding: 2px 6px;
+  font-size: 12px;
+  font-family: inherit;
+  font-weight: 500;
+  line-height: 1.5;
+  color: var(--vp-c-text-3);
+  background: var(--vp-c-default-soft);
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 4px;
+  pointer-events: none;
+}
+
+.input[type="search"]::-webkit-search-cancel-button {
+  -webkit-appearance: none;
+  appearance: none;
+  display: none;
+}
+
+.input[type="search"]::-ms-clear {
+  display: none;
+}
+
+.input[type="search"]::-o-clear {
+  display: none;
+}
+
+.input[type="search"]::-moz-clear {
+  display: none;
+}
+
+@media (hover: none) {
+  .shortcut {
+    display: none;
+  }
+
+  .clear-button {
+    right: 16px !important;
+  }
+}
 </style>
 
 <style>
-.input-wrapper svg {
+.input-wrapper > svg {
   position: absolute;
   left: 16px;
   top: 12px;
@@ -78,4 +190,7 @@ defineExpose({
   color: var(--vp-c-text-2);
   pointer-events: none;
 }
+.input-wrapper > svg:has(+ .input.has-icon:focus) {
+  color: var(--vp-c-text-1);
+}
 </style>

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

@@ -1,37 +1,36 @@
 <script lang="ts">
 export default {
   inheritAttrs: false,
-}
+};
 </script>
 
 <script setup lang="ts">
-import { computed, ref } from 'vue'
-import Input from './Input.vue'
-import createLucideIcon from 'lucide-vue-next/src/createLucideIcon'
-import { search }  from '../../../data/iconNodes'
-
-const SearchIcon = createLucideIcon('search', search)
+import { computed, ref } from 'vue';
+import Input from './Input.vue';
+import Icon from '@lucide/vue/src/Icon';
+import { search } from '../../../data/iconNodes';
 
 interface Props {
-  modelValue: string
+  modelValue: string;
+  shortcut?: string;
 }
 
-const props = defineProps<Props>()
+const props = defineProps<Props>();
 
-const input = ref()
+const input = ref();
 
-const emit = defineEmits(['update:modelValue'])
+const emit = defineEmits(['update:modelValue']);
 
 defineExpose({
   focus: () => {
-    input.value.focus()
-  }
-})
+    input.value.focus();
+  },
+});
 
 const value = computed({
   get: () => props.modelValue,
-  set: (val) => emit('update:modelValue', val)
-})
+  set: (val) => emit('update:modelValue', val),
+});
 </script>
 
 <template>
@@ -39,12 +38,16 @@ const value = computed({
     ref="input"
     type="search"
     autofocus
+    :shortcut="shortcut"
     v-bind="$attrs"
     v-model="value"
     class="input-wrapper"
   >
     <template #icon>
-      <component :is="SearchIcon" class="search-icon" />
+      <Icon
+        :iconNode="search"
+        class="search-icon"
+      />
     </template>
   </Input>
 </template>
@@ -60,7 +63,8 @@ const value = computed({
   background-color: var(--vp-c-bg-alt);
 }
 
-.input:hover, .input:focus {
+.input:hover,
+.input:focus {
   border-color: var(--vp-c-brand);
   background: var(--vp-c-bg-alt);
 }
@@ -71,5 +75,4 @@ const value = computed({
   font-size: 14px;
   height: 48px;
 }
-
 </style>

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

@@ -0,0 +1,66 @@
+<script setup lang="ts">
+import VPLink from 'vitepress/dist/client/theme-default/components/VPLink.vue';
+</script>
+
+<template>
+  <div class="top-notification">
+    <p>
+      <VPLink
+        class="notification-link"
+        href="/guide/version-1"
+        >Lucide v1 is out!</VPLink
+      >🚀<br />
+      You're looking at the site for v1, for v0 go to
+      <VPLink
+        class="notification-link"
+        href="https://v0.lucide.dev"
+        >v0 site</VPLink
+      >
+    </p>
+  </div>
+</template>
+
+<style>
+:root {
+  --vp-layout-top-height: 64px;
+}
+
+@media (min-width: 640px) {
+  :root {
+    --vp-layout-top-height: 32px;
+  }
+}
+</style>
+
+<style scoped>
+.top-notification {
+  position: fixed;
+  top: 0;
+  left: 0;
+  width: 100%;
+  z-index: 9999;
+  display: flex;
+  height: var(--vp-layout-top-height);
+  justify-content: center;
+  align-items: center;
+  background: var(--vp-c-brand-dark);
+  color: var(--vp-c-bg-alt-down);
+  font-size: 14px;
+  padding: 0 16px;
+}
+
+.notification-link {
+  font-weight: 500;
+  text-decoration: underline;
+}
+
+.notification-link::after {
+  display: none !important;
+}
+
+@media (min-width: 640px) {
+  .top-notification br {
+    display: none;
+  }
+}
+</style>

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

@@ -1,17 +1,17 @@
 <script setup lang="ts">
-import createLucideIcon from 'lucide-vue-next/src/createLucideIcon';
+import createLucideIcon from '@lucide/vue/src/createLucideIcon';
 
-export type IconNode = [elementName: string, attrs: Record<string, string>][]
+export type IconNode = [elementName: string, attrs: Record<string, string>][];
 
 const props = defineProps<{
   name: string;
-  tags: string[];
-  categories: string[];
+  tags?: string[];
+  categories?: string[];
   // contributors: Contributor[];
   iconNode: IconNode;
-}>()
+}>();
 
-const icon = createLucideIcon(props.name, props.iconNode)
+const icon = createLucideIcon(props.name, props.iconNode);
 </script>
 
 <template>

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

@@ -0,0 +1,61 @@
+<script setup lang="ts">
+import VPLink from 'vitepress/dist/client/theme-default/components/VPLink.vue';
+
+defineProps<{
+  href?: string;
+  title?: string;
+  desc?: string;
+}>();
+</script>
+
+<template>
+  <VPLink
+    class="overview-link"
+    :href="href"
+  >
+    <span class="title">
+      {{ title }}
+    </span>
+    <span
+      v-if="desc"
+      class="desc"
+    >
+      {{ desc }}
+    </span>
+  </VPLink>
+</template>
+
+<style scoped>
+.overview-link {
+  display: block;
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 8px;
+  padding: 11px 16px 13px;
+  width: 100%;
+  height: 100%;
+  transition: border-color 0.25s;
+  text-decoration: none;
+}
+
+.overview-link:hover {
+  border-color: var(--vp-c-brand-1);
+}
+
+.desc {
+  display: block;
+  line-height: 20px;
+  font-size: 12px;
+  font-weight: 500;
+  color: var(--vp-c-text-2);
+  margin-top: 2px;
+}
+
+.title {
+  display: block;
+  line-height: 20px;
+  font-size: 14px;
+  font-weight: 500;
+  color: var(--vp-c-brand-1);
+  transition: color 0.25s;
+}
+</style>