feat(icons): added layer reordering icons (#4617 )

* Added icons/layer-arrow-up.svg * Added icons/layer-arrow-up.json * Added icons/layers-arrow-up.svg * Added icons/layers-arrow-up.json * Added icons/layers-arrow-down.svg * Added icons/layers-arrow-down.json * Added icons/layer-arrow-down.svg * Added icons/layer-arrow-down.json * Apply suggestions from code review Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> * fix(icons): add missing use cases to layer reordering icons --------- Co-authored-by: Eric Fennis <eric.fennis@gmail.com> Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
chore(deps): bump the github-actions group with 13 updates (#4668 )
2026-11-11 13:28:19 +00:00 · 2026-08-06 13:41:39 +02:00 · 2026-08-06 13:37:32 +02:00 · 2026-08-06 13:36:53 +02:00 · 2026-08-06 13:36:27 +02:00 · 2026-08-06 12:19:24 +02:00
1294 changed files with 27869 additions and 11804 deletions
@@ -9,3 +9,4 @@ strikethrough
 touchpad
 ungroup
 toc
+sunlounger
@@ -0,0 +1,104 @@
+version: 2
+
+updates:
+  - package-ecosystem: npm
+    directory: /
+    schedule:
+      interval: weekly
+    groups:
+      react-deps:
+        patterns:
+          - '@testing-library/react'
+          - '@types/prop-types'
+          - '@types/react'
+          - '@vitejs/plugin-react'
+          - 'react'
+          - 'react-dom'
+      vue-deps:
+        patterns:
+          - '@testing-library/vue'
+          - '@vitejs/plugin-vue'
+          - '@vue/test-utils'
+          - 'vue'
+      svelte-deps:
+        patterns:
+          - '@sveltejs/*'
+          - '@testing-library/svelte'
+          - '@tsconfig/svelte'
+          - 'svelte'
+          - 'svelte-check'
+          - 'svelte-preprocess'
+      solid-deps:
+        patterns:
+          - '@babel/*'
+          - '@rollup/plugin-babel'
+          - '@solidjs/testing-library'
+          - 'babel-preset-solid'
+          - 'solid-js'
+          - 'vite-plugin-solid'
+      react-native-deps:
+        patterns:
+          - 'react-native'
+          - 'react-native-svg'
+      angular-deps:
+        patterns:
+          - '@angular/*'
+          - '@angular-eslint/*'
+          - '@vitest/browser-playwright'
+          - 'angular-eslint'
+          - 'ng-packagr'
+          - 'rxjs'
+          - 'tslib'
+      preact-deps:
+        patterns:
+          - '@preact/preset-vite'
+          - '@testing-library/preact'
+          - 'preact'
+      astro-deps:
+        patterns:
+          - '@astrojs/*'
+          - 'astro'
+      testing-deps:
+        patterns:
+          - '@testing-library/*'
+          - '@vitest/*'
+          - 'jest-serializer-html'
+          - 'jsdom'
+          - 'linkedom'
+          - 'vitest'
+      build-deps:
+        patterns:
+          - '@rollup/*'
+          - '@vitejs/*'
+          - 'esbuild'
+          - 'rollup'
+          - 'rollup-plugin-*'
+          - 'typescript'
+          - 'vite'
+          - 'vite-plugin-*'
+      linting-deps:
+        patterns:
+          - '@html-eslint/*'
+          - '@typescript-eslint/*'
+          - 'cspell'
+          - 'eslint'
+          - 'eslint-*'
+          - 'husky'
+          - 'lint-staged'
+          - 'prettier'
+          - 'prettier-plugin-*'
+      types-deps:
+        patterns:
+          - '@types/*'
+      remaining-deps:
+        patterns:
+          - '*'
+
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: monthly
+    groups:
+      github-actions:
+        patterns:
+          - '*'
@@ -13,7 +13,7 @@ The `contributors` property is a required array of GitHub usernames for the peop

 The `tags` property is an array of strings that describe the icon and can be used for searching.
 Validate the tags against the `icon.schema.json` to ensure they are correctly formatted and adhere to the defined structure.
-Provide tag suggestions based on the name of the icon and the use cases provided in the PR description. Use the existing tags in the repository as a reference for consistency and to avoid duplicates. Don't suggest words like: 'icon' and preferably use single words. Tags should always be in lowercase and should not contain spaces. The name of icon should not be included in the tags, as it is already specified.
+Provide tag suggestions based on the name of the icon and the use cases provided in the PR description. Use the existing tags in the repository as a reference for consistency and to avoid duplicates. Don't suggest words like: 'icon' and preferably use single words. Tags should always be in lowercase, and may also contain spaces (e.g. `magnifying glass`). The name of icon should not be included in the tags, as it is already specified.

 # Categories

@@ -47,7 +47,9 @@ Common scopes: icons, docs, studio, site, dev

 ### Design <!-- ONLY for new icons -->
 <!-- All of these requirements must be fulfilled. -->
+
 - [ ] I've read and followed the [icon design guidelines](https://lucide.dev/contribute/icon-design-guide)
+- [ ] I've made sure that the icons don't [already exist](https://lucide.dev/icons), including the [Lab directory](https://github.com/lucide-icons/lucide/tree/main/lab).
 - [ ] I've made sure that the icons look sharp on low DPI displays.
 - [ ] I've made sure that the icons look consistent with the icon set in size, optical volume and density.
 - [ ] I've made sure that the icons are visually centered.
@@ -7,13 +7,16 @@ on:
      - tools/build-icons/**
      - pnpm-lock.yaml

+permissions:
+  contents: read
+
 jobs:
  build:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v6
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -27,9 +30,9 @@ jobs:
  test:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v6
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -23,13 +23,7 @@ on:
          - 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
+permissions: {}

 jobs:
  check-dispatch-gate:
@@ -37,10 +31,12 @@ jobs:
      startsWith(github.event.head_commit.message, 'feat(icons)') &&
      github.event_name != 'workflow_dispatch'
    runs-on: ubuntu-latest
+    permissions:
+      contents: read
    outputs:
      RELEASE_ENVIRONMENT: ${{ steps.environment.outputs.RELEASE_ENVIRONMENT }}
    steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7

      - name: Fetch tags
        run: git fetch --all --tags
@@ -64,12 +60,14 @@ jobs:
    needs: check-dispatch-gate
    environment: ${{ needs.check-dispatch-gate.outputs.RELEASE_ENVIRONMENT }}
    runs-on: ubuntu-latest
+    permissions:
+      contents: write # Required to create the release and tag
    outputs:
      VERSION: ${{ steps.new-version.outputs.NEW_VERSION }}
    steps:
-      - uses: actions/checkout@v6
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -104,7 +102,7 @@ jobs:
          echo '${{ steps.change-log.outputs.CHANGE_LOG }}'

      - name: Create Release
-        uses: softprops/action-gh-release@v1
+        uses: softprops/action-gh-release@v3
        with:
          tag_name: ${{ steps.new-version.outputs.NEW_VERSION }}
          name: Version ${{ steps.new-version.outputs.NEW_VERSION }}
@@ -115,13 +113,19 @@ jobs:
    needs: create-release
    uses: './.github/workflows/release.yml'
    secrets: inherit
+    permissions:
+      id-token: write # Required for OIDC (npm provenance)
+      contents: write # Required to upload release assets
    with:
      version: ${{ needs.create-release.outputs.VERSION }}

  dispatch-release:
-    if: github.event_name == 'workflow_dispatch'
+    if: github.repository == 'lucide-icons/lucide' && github.event_name == 'workflow_dispatch'
    uses: './.github/workflows/release.yml'
    secrets: inherit
+    permissions:
+      id-token: write # Required for OIDC (npm provenance)
+      contents: write # Required to upload release assets
    with:
      version: ${{ inputs.version }}
      tag: ${{ inputs.tag }}
@@ -4,14 +4,21 @@ on:
  issues:
    types: [opened]

+permissions: {}
+
+env:
+  GH_TOKEN: ${{ github.token }}
+
 jobs:
  block_phrases:
+    if: github.repository == 'lucide-icons/lucide'
    runs-on: ubuntu-latest
    permissions:
+      contents: read
      issues: write
    steps:
      - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7

      - name: Load stopwords from JSON & check issue title & body
        if: contains(github.event.issue.labels.*.name, '🙌 icon request')
@@ -33,7 +40,7 @@ jobs:

          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)
+          [Click here to read our official statement about brand logos in Lucide.](https://github.com/lucide-icons/lucide/blob/main/BRAND_LOGOS_STATEMENT.md)

          You can [search for similar issues.](https://github.com/lucide-icons/lucide/issues?q=is%3Aissue+${VALUE})

@@ -43,6 +50,3 @@ jobs:
              exit 0
            fi
          done
-
-env:
-  GH_TOKEN: ${{ github.token }}
@@ -3,13 +3,16 @@ on:
  schedule:
    - cron: '45 1 * * *'

+permissions: {}
+
 jobs:
  stale:
+    if: github.repository == 'lucide-icons/lucide'
    runs-on: ubuntu-latest
    permissions:
      pull-requests: write
    steps:
-      - uses: actions/stale@v9
+      - uses: actions/stale@v11
        with:
          repo-token: ${{ secrets.GITHUB_TOKEN }}
          stale-pr-message: This PR is stale because it has been open 45 days with no activity. Remove stale label or comment or this will be closed in 5 days.
@@ -6,15 +6,22 @@ on:
    types:
      - completed

+permissions: {}
+
 jobs:
  upload:
    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      actions: read # Required to download the artifact from the triggering run
+      pull-requests: write
    if: >
+      github.repository == 'lucide-icons/lucide' &&
      github.event.workflow_run.event == 'pull_request' &&
      github.event.workflow_run.conclusion == 'success'
    steps:
      - name: 'Download artifact'
-        uses: actions/github-script@v7
+        uses: actions/github-script@v9
        with:
          script: |
            let allArtifacts = await github.rest.actions.listWorkflowRunArtifacts({
@@ -42,7 +49,7 @@ jobs:
        id: pr-number

      - name: Find Comment
-        uses: peter-evans/find-comment@v2
+        uses: peter-evans/find-comment@v4
        id: pr-comment
        with:
          issue-number: ${{ steps.pr-number.outputs.number }}
@@ -50,7 +57,7 @@ jobs:
          body-includes: Added or changed icons

      - name: Create or update comment
-        uses: peter-evans/create-or-update-comment@v3
+        uses: peter-evans/create-or-update-comment@v5
        with:
          comment-id: ${{ steps.pr-comment.outputs.comment-id }}
          issue-number: ${{ steps.pr-number.outputs.number }}
@@ -9,13 +9,16 @@ on:
      - tools/rollup-plugins/**
      - pnpm-lock.yaml

+permissions:
+  contents: read
+
 jobs:
  build:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v6
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -29,9 +32,9 @@ jobs:
  test:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v6
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -2,12 +2,15 @@ name: 'Pull Request Labeler'
 on:
  - pull_request_target

+permissions: {}
+
 jobs:
  triage:
+    if: github.repository == 'lucide-icons/lucide'
    permissions:
      contents: read
      pull-requests: write
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v6
-      - uses: actions/labeler@v5
+      - uses: actions/checkout@v7
+      - uses: actions/labeler@v7
@@ -1,17 +1,18 @@
-name: Linting PR
+name: Linting PR code

 on:
  pull_request:
-    paths-ignore:
-      - icons/*.svg
+
+permissions:
+  contents: read

 jobs:
  lint-code:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v6
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -1,4 +1,4 @@
-name: Linting PR
+name: Linting PR title

 on:
  pull_request:
@@ -7,12 +7,16 @@ on:
      - edited
      - reopened

+permissions:
+  contents: read
+  pull-requests: read # Required to read the PR title
+
 jobs:
  lint-pr-title:
    name: PR Title Lint
    runs-on: ubuntu-latest
    steps:
-      - uses: amannn/action-semantic-pull-request@v5
+      - uses: amannn/action-semantic-pull-request@v6
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        with:
@@ -7,6 +7,9 @@ on:
  pull_request:
    paths:
      - 'icons/*'
+      - 'lab/*'
+
+permissions: {}

 jobs:
  lint-filenames:
@@ -16,27 +19,54 @@ jobs:
    permissions:
      contents: read
    steps:
-      - uses: actions/checkout@v6
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
+          cache: 'pnpm'
          node-version-file: 'package.json'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
      - name: Get changed files
        id: changed-files
-        uses: tj-actions/changed-files@v46
+        uses: tj-actions/changed-files@v47
        with:
-          files: icons/*
+          files: |
+            icons/*
+            lab/*

      - name: Generate annotations
        run: node ./scripts/lintFilenames.mts
        env:
          CHANGED_FILES: ${{ steps.changed-files.outputs.all_changed_files }}

+  check-lab-icons:
+    name: Check Lab Icons
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
+        with:
+          cache: 'pnpm'
+          node-version-file: 'package.json'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Check lab icons do not already exist in icons
+        run: node ./scripts/checkLabIcons.mts
+
  lint-aliases:
    name: Check Uniqueness of Aliases
    runs-on: ubuntu-latest
    permissions:
      contents: read
    steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
      - 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 '"
@@ -11,13 +11,16 @@ on:
      - tools/build-icons/**
      - pnpm-lock.yaml

+permissions:
+  contents: read
+
 jobs:
  build:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v6
-      - uses: pnpm/action-setup@v2
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          node-version-file: 'package.json'
          cache: 'pnpm'
@@ -31,9 +34,9 @@ jobs:
  test:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v3
-      - uses: pnpm/action-setup@v2
-      - uses: actions/setup-node@v3.8.1
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          node-version-file: 'package.json'
          cache: 'pnpm'
@@ -9,13 +9,16 @@ on:
      - tools/build-font/**
      - pnpm-lock.yaml

+permissions:
+  contents: read
+
 jobs:
  lucide-font:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v6
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -30,7 +33,7 @@ jobs:
        run: pnpm build:font

      - name: 'Upload to Artifacts'
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v7
        with:
          name: lucide-font
          path: lucide-font
@@ -0,0 +1,30 @@
+name: Lucide Lab checks
+
+on:
+  pull_request:
+    paths:
+      - packages/lab/**
+      - packages/shared/**
+      - tools/build-icons/**
+      - tools/rollup-plugins/**
+      - pnpm-lock.yaml
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
+        with:
+          cache: 'pnpm'
+          node-version-file: 'package.json'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build
+        run: pnpm --filter @lucide/lab build
@@ -12,13 +12,16 @@ on:
      - tools/rollup-plugins/**
      - pnpm-lock.yaml

+permissions:
+  contents: read
+
 jobs:
  lucide-preact:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v6
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -12,13 +12,16 @@ on:
      - tools/rollup-plugins/**
      - pnpm-lock.yaml

+permissions:
+  contents: read
+
 jobs:
  build:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v6
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -32,9 +35,9 @@ jobs:
  test:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v6
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -13,13 +13,16 @@ on:
      - scripts/generateNextJSAliases.mjs
      - pnpm-lock.yaml

+permissions:
+  contents: read
+
 jobs:
  build:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v6
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -33,9 +36,9 @@ jobs:
  test:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v6
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -9,13 +9,16 @@ on:
      - packages/shared/**
      - pnpm-lock.yaml

+permissions:
+  contents: read
+
 jobs:
  test:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v6
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -12,13 +12,16 @@ on:
      - tools/rollup-plugins/**
      - pnpm-lock.yaml

+permissions:
+  contents: read
+
 jobs:
  build:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v6
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -32,9 +35,9 @@ jobs:
  test:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v6
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -7,13 +7,16 @@ on:
      - tools/build-icons/**
      - pnpm-lock.yaml

+permissions:
+  contents: read
+
 jobs:
  lucide-static:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v6
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -12,13 +12,16 @@ on:
      - tools/rollup-plugins/**
      - pnpm-lock.yaml

+permissions:
+  contents: read
+
 jobs:
  build:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v6
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -32,9 +35,9 @@ jobs:
  test:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v6
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -48,9 +51,9 @@ jobs:
  typecheck:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v6
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -6,19 +6,22 @@ on:
      - next
  pull_request:
    paths:
-      - packages/lucide-vue/**
+      - packages/vue/**
      - packages/shared/**
      - tools/build-icons/**
      - tools/rollup-plugins/**
      - pnpm-lock.yaml

+permissions:
+  contents: read
+
 jobs:
  build:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -32,9 +35,9 @@ jobs:
  test:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -11,13 +11,16 @@ on:
      - tools/rollup-plugins/**
      - pnpm-lock.yaml

+permissions:
+  contents: read
+
 jobs:
  build:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v6
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -31,9 +34,9 @@ jobs:
  test:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v6
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -5,27 +5,30 @@ on:
    paths:
      - 'icons/*.svg'

+permissions: {}
+
 jobs:
  generate-changed-icons-comment:
    name: Generate Changed Icons Comment
+    if: github.repository == 'lucide-icons/lucide'
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write

    steps:
-      - uses: actions/checkout@v6
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: actions/setup-node@v7.0.0
        with:
          node-version-file: 'package.json'

      - name: Get changed files
        id: changed-files
-        uses: tj-actions/changed-files@v46
+        uses: tj-actions/changed-files@v47
        with:
          files: icons/*.svg

-      - uses: actions/setup-node@v6
+      - uses: actions/setup-node@v7.0.0
      - name: Install svgson for code preview (safer and faster than installing all deps)
        run: npm install svgson@5.3.1 --force

@@ -40,7 +43,7 @@ jobs:
        env:
          CHANGED_FILES: ${{ steps.changed-files.outputs.all_changed_files }}

-      - uses: actions/upload-artifact@v4
+      - uses: actions/upload-artifact@v7
        with:
          name: pr_number
          path: pr/
@@ -1,13 +1,16 @@
-name: Pull request tags suggestions
+name: Pull request metadata suggestions

 on:
  pull_request_target:
    paths:
      - 'icons/*.json'

+permissions: {}
+
 jobs:
-  pull-request-tags-suggestions:
-    name: Pull Request Tags Suggestions
+  pull-request-metadata-suggestions:
+    name: Pull Request Metadata Suggestions
+    if: github.repository == 'lucide-icons/lucide'
    runs-on: ubuntu-latest
    permissions:
      contents: read
@@ -16,11 +19,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@v6
+      - uses: actions/checkout@v7
        with:
          repository: lucide-icons/lucide
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v6
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -29,7 +32,7 @@ jobs:
        run: pnpm install --frozen-lockfile

      - name: Generate comment markup
-        run: node ./scripts/suggestTags.mts
+        run: node ./scripts/suggestMetaData.mts
        env:
          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
          PULL_REQUEST_NUMBER: ${{ github.event.number }}
@@ -16,12 +16,7 @@ on:
        default: 'latest'
        type: string

-permissions:
-  id-token: write # Required for OIDC
-  contents: write
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
+permissions: {}

 jobs:
  prepare:
@@ -29,7 +24,6 @@ jobs:
    runs-on: ubuntu-latest
    outputs:
      VERSION: ${{ steps.get_version.outputs.VERSION }}
-
    steps:
      - name: Get the version
        id: get_version
@@ -63,9 +57,9 @@ jobs:
            '@lucide/vue',
          ]
    steps:
-      - uses: actions/checkout@v6
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -74,7 +68,7 @@ jobs:
        run: pnpm install --frozen-lockfile

      - name: Set new version
-        run: pnpm --fail-if-no-match --filter ${{ matrix.package }} version --new-version ${{ needs.prepare.outputs.VERSION }} --no-git-tag-version
+        run: pnpm version ${{ needs.prepare.outputs.VERSION }} --filter ${{ matrix.package }} --fail-if-no-match --no-git-tag-version

      - name: Build
        run: pnpm --filter ${{ matrix.package }} build
@@ -96,10 +90,10 @@ jobs:
      contents: read

    steps:
-      - uses: actions/checkout@v6
-      - uses: actions/download-artifact@v4
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: actions/download-artifact@v8
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -108,7 +102,7 @@ jobs:
        run: pnpm install --frozen-lockfile

      - name: Set new version
-        run: pnpm --filter lucide-static version --new-version ${{ needs.prepare.outputs.VERSION }} --no-git-tag-version
+        run: pnpm version ${{ needs.prepare.outputs.VERSION }} --filter lucide-static --no-git-tag-version

      - name: Move Font
        run: cp -r lucide-font packages/lucide-static/font
@@ -125,10 +119,12 @@ jobs:
    if: github.repository == 'lucide-icons/lucide'
    runs-on: ubuntu-latest
    needs: prepare
+    permissions:
+      contents: read
    steps:
-      - uses: actions/checkout@v6
-      - uses: pnpm/action-setup@v4
-      - uses: actions/setup-node@v6
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7.0.0
        with:
          cache: 'pnpm'
          node-version-file: 'package.json'
@@ -145,7 +141,7 @@ jobs:
          BLOB_READ_WRITE_TOKEN: ${{ secrets.BLOB_READ_WRITE_TOKEN }}

      - name: 'Upload to Artifacts'
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v7
        with:
          name: lucide-font
          path: lucide-font
@@ -155,18 +151,17 @@ jobs:
    runs-on: ubuntu-latest
    needs: [prepare, lucide-font]
    permissions:
-      id-token: write # Required for OIDC
-      contents: write
+      contents: write # Required to upload the release assets
    steps:
-      - uses: actions/checkout@v6
-      - uses: actions/download-artifact@v4
+      - uses: actions/checkout@v7
+      - uses: actions/download-artifact@v8
      - name: Zip font and icons
        run: |
          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
+        uses: softprops/action-gh-release@v3
        with:
          tag_name: ${{ needs.prepare.outputs.VERSION }}

@@ -0,0 +1,45 @@
+name: Weekly Repo Report
+on:
+  workflow_dispatch:
+  # Run this workflow every Monday at 07:00 UTC
+  schedule:
+    - cron: '0 7 * * 1'
+
+permissions:
+  contents: read
+
+jobs:
+  weekly-summary:
+    if: github.repository == 'lucide-icons/lucide'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Set up Node.js environment
+        uses: actions/setup-node@v7.0.0
+        with:
+          node-version: 24
+
+      - name: Install Copilot CLI
+        run: npm install -g @github/copilot
+
+      - name: Run the prompt
+        env:
+          COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
+        run: |
+          copilot -p "${{ vars.REPO_REPORT_PROMPT }} Write the details to summary.md" --allow-tool='shell(git:*)' --allow-tool=write --no-ask-user
+          cat summary.md >> "$GITHUB_STEP_SUMMARY"
+
+      - name: Post report to Discord (private channel)
+        env:
+          DISCORD_WEBHOOK_URL: ${{ secrets.LUCIDE_DISCORD_WEBHOOK }}
+        run: |
+          jq -Rs '{
+            embeds: [{
+              title: "📊 Weekly Repo Report",
+              description: (.[0:4096]),
+              color: 5814783
+            }]
+          }' summary.md > payload.json
+          curl -sS --fail -X POST \
+            -H "Content-Type: application/json" \
+            -d @payload.json \
+            "$DISCORD_WEBHOOK_URL"
@@ -1,25 +1,27 @@
-name: 'Request Review'
+name: Request Review
 on:
-  pull_request_target:
+  pull_request:
    types: [opened]
    paths:
      - icons/*.svg

+permissions: {}
+
 jobs:
  request-review:
-    if: github.event.pull_request.draft == false
+    if: github.repository == 'lucide-icons/lucide' && github.event.pull_request.draft == false
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
    steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
        with:
          fetch-depth: 0
          ref: refs/pull/${{ github.event.pull_request.number }}/merge
      - name: Get changed files
        id: changed-files
-        uses: tj-actions/changed-files@v41
+        uses: tj-actions/changed-files@v47
        with:
          files: icons/*.svg
      - run: |
@@ -53,8 +53,11 @@ docs/.vitepress/data/categoriesData.json
 docs/.vitepress/data/iconDetails
 docs/.vitepress/data/relatedIcons.json
 docs/.vitepress/data/brandStopwords.json
+docs/.vitepress/data/iconPopularity
+docs/.vitepress/data/lab/iconNodes
+docs/.vitepress/data/lab/iconMetaData.ts
+docs/.vitepress/data/lab/iconPopularity
 docs/.vercel
 docs/.nitro
 docs/public/og/**
 !docs/public/og/general.png
-.gitignore
@@ -30,7 +30,7 @@ Read it here: [ICON_GUIDELINES](https://lucide.dev/contribute/icon-design-guide)

 #### Lucide Studio

-For formatting and adjusting SVG icons, [@jguddas](https://github.com/jguddas) made a great tool called [Lucide Studio](https://studio.lucide.dev/). It is a web-based SVG editor that allows you to edit and adjust icons in the Lucide style. You can use it to create new icons or modify existing ones.
+For formatting and adjusting SVG icons, [@jguddas](https://github.com/jguddas) made a great tool called [Lucide Studio](https://studio.lucide.dev/?utm_source=lucide.dev&utm_medium=contributing-guide). It is a web-based SVG editor that allows you to edit and adjust icons in the Lucide style. You can use it to create new icons or modify existing ones.

 #### Editor guides

@@ -35,7 +35,7 @@ Lucide is an open-source icon library that provides 1600+ vector (svg) files for
 | <img src="https://lucide.dev/framework-logos/js.svg" alt="JS logo" width="48"> | **`lucide`** | [![npm](https://img.shields.io/npm/v/lucide)](https://www.npmjs.com/package/lucide) | ![NPM Downloads](https://img.shields.io/npm/dw/lucide) | [Docs](https://lucide.dev/guide/lucide) · [Source](./packages/lucide) |
 | <img src="https://lucide.dev/framework-logos/react.svg" alt="React logo" width="48"> | **`lucide-react`** | [![npm](https://img.shields.io/npm/v/lucide-react)](https://www.npmjs.com/package/lucide-react) | ![NPM Downloads](https://img.shields.io/npm/dw/lucide-react) | [Docs](https://lucide.dev/guide/react) · [Source](./packages/lucide-react) |
 | <img src="https://lucide.dev/framework-logos/vue.svg" alt="Vue logo" width="48"> | **`@lucide/vue`** | [![npm](https://img.shields.io/npm/v/@lucide/vue)](https://www.npmjs.com/package/@lucide/vue) | ![NPM Downloads](https://img.shields.io/npm/dw/@lucide/vue) | [Docs](https://lucide.dev/guide/vue) · [Source](./packages/vue) |
-| <img src="https://lucide.dev/framework-logos/svelte.svg" alt="Svelte logo" width="48"> | **`@lucide/svelte`** | [![npm](https://img.shields.io/npm/v/@lucide/svelte)](https://www.npmjs.com/package/@lucide/svelte) | ![NPM Downloads](https://img.shields.io/npm/dw/@lucide/svelte) | [Docs](https://lucide.dev/guide/svelte) · [Source](./packages/@lucide/svelte) |
+| <img src="https://lucide.dev/framework-logos/svelte.svg" alt="Svelte logo" width="48"> | **`@lucide/svelte`** | [![npm](https://img.shields.io/npm/v/@lucide/svelte)](https://www.npmjs.com/package/@lucide/svelte) | ![NPM Downloads](https://img.shields.io/npm/dw/@lucide/svelte) | [Docs](https://lucide.dev/guide/svelte) · [Source](./packages/svelte) |
 | <img src="https://lucide.dev/framework-logos/solid.svg" alt="Solid logo" width="48"> | **`lucide-solid`** | [![npm](https://img.shields.io/npm/v/lucide-solid)](https://www.npmjs.com/package/lucide-solid) | ![NPM Downloads](https://img.shields.io/npm/dw/lucide-solid) | [Docs](https://lucide.dev/guide/solid) · [Source](./packages/lucide-solid) |
 | <img src="https://lucide.dev/framework-logos/preact.svg" alt="Preact logo" width="48"> | **`lucide-preact`** | [![npm](https://img.shields.io/npm/v/lucide-preact)](https://www.npmjs.com/package/lucide-preact) | ![NPM Downloads](https://img.shields.io/npm/dw/lucide-preact) | [Docs](https://lucide.dev/guide/preact) · [Source](./packages/lucide-preact) |
 | <img src="https://lucide.dev/framework-logos/react-native.svg" alt="React Native logo" width="48"> | **`lucide-react-native`** | [![npm](https://img.shields.io/npm/v/lucide-react-native)](https://www.npmjs.com/package/lucide-react-native) | ![NPM Downloads](https://img.shields.io/npm/dw/lucide-react-native) | [Docs](https://lucide.dev/guide/react-native) · [Source](./packages/lucide-react-native) |
@@ -56,7 +56,6 @@
  "kubernetes": "Kubernetes",
  "leetcode": "LeetCode",
  "leet-code": "LeetCode",
-  "line": "LINE",
  "linkedin": "LinkedIn",
  "lua": "Lua",
  "mariadb": "MariaDB",
@@ -69,7 +68,7 @@
  "nestjs": "NestJS",
  "netflix": "Netflix",
  "netlify": "Netlify",
-  "next": "Next.js",
+  "nextjs": "Next.js",
  "nodejs": "Node.js",
  "notion": "Notion",
  "nostr": "Nostr",
@@ -105,7 +104,8 @@
  "shopify": "Shopify",
  "skype": "Skype",
  "slack": "Slack",
-  "solid": "SolidJS",
+  "snapchat": "Snapchat",
+  "solidjs": "SolidJS",
  "soundcloud": "SoundCloud",
  "spotify": "Spotify",
  "sqlite": "SQLite",
@@ -144,6 +144,5 @@
  "xbox": "Xbox",
  "yarn": "Yarn",
  "youtube": "YouTube",
-  "zig": "Zig",
-  "zoom": "Zoom"
+  "zig": "Zig"
 }
@@ -1,5 +1,5 @@
 {
  "$schema": "../category.schema.json",
-  "title": "Navigation, Maps, and POIs",
+  "title": "Navigation & Places",
  "icon": "compass"
 }
@@ -0,0 +1,25 @@
+import { eventHandler, setResponseHeader } from 'h3';
+import iconMetaData from '../../../data/lab/iconMetaData';
+import iconPopularity from '../../../data/lab/iconPopularity';
+import iconNodes from '../../../data/lab/iconNodes';
+
+export default eventHandler((event) => {
+  setResponseHeader(event, 'Access-Control-Allow-Origin', '*');
+
+  return Object.fromEntries(
+    Object.entries(iconMetaData).map(([iconName, iconData]) => {
+      // Remove $schema from the response
+      delete iconData['$schema'];
+
+      return [
+        iconName,
+        {
+          name: iconName,
+          iconNode: iconNodes[iconName],
+          popularity: iconPopularity[iconName]?.count ?? 0,
+          ...iconData,
+        },
+      ];
+    }),
+  );
+});
@@ -0,0 +1,14 @@
+import { eventHandler, setResponseHeader } from 'h3';
+import iconMetaData from '../../../data/lab/iconMetaData';
+
+export default eventHandler((event) => {
+  setResponseHeader(event, 'Cache-Control', 'public, max-age=86400');
+  setResponseHeader(event, 'Access-Control-Allow-Origin', '*');
+
+  for (const iconDetail in iconMetaData) {
+    // Remove $schema from the response
+    delete iconMetaData[iconDetail]['$schema'];
+  }
+
+  return iconMetaData;
+});
@@ -0,0 +1,30 @@
+import { eventHandler, getQuery, setResponseHeader } from 'h3';
+import iconNodes from '../../../data/lab/iconNodes';
+type IconNodeWithKeys = [elementName: string, attrs: Record<string, string> & { key?: string }][];
+
+export default eventHandler((event) => {
+  const query = getQuery(event);
+
+  const withUniqueKeys = query.withUniqueKeys === 'true';
+
+  setResponseHeader(event, 'Cache-Control', 'public, max-age=86400');
+  setResponseHeader(event, 'Access-Control-Allow-Origin', '*');
+
+  if (withUniqueKeys) {
+    return iconNodes;
+  }
+
+  return Object.entries(iconNodes).reduce((acc, [name, iconNode]) => {
+    if (withUniqueKeys) {
+      return [name, iconNode];
+    }
+
+    const newIconNode = (iconNode as IconNodeWithKeys).map(([name, { key, ...attrs }]) => {
+      return [name, attrs];
+    });
+
+    acc[name] = newIconNode;
+
+    return acc;
+  }, {});
+});
@@ -101,6 +101,7 @@ export default defineConfig({
      },
      { text: 'Packages', link: '/packages' },
      { text: 'Showcase', link: '/showcase' },
+      { text: 'Merch', link: 'https://merch.lucide.dev/' },
    ],
    sidebar,
    socialLinks: [
@@ -109,7 +110,7 @@ export default defineConfig({
    ],
    footer: {
      message: 'Released under the ISC License.',
-      copyright: `Copyright © ${new Date().getFullYear()} Lucide Contributors`,
+      copyright: `Copyright © ${new Date().getFullYear()} Lucide Icons`,
    },
    editLink: {
      pattern: 'https://github.com/lucide-icons/lucide/edit/main/docs/:path',
@@ -97,7 +97,7 @@
  },
  {
    "name": "navigation",
-    "title": "Navigation, Maps, and POIs"
+    "title": "Navigation & Places"
  },
  {
    "name": "notifications",
@@ -46,21 +46,5 @@
      "light": "/company-logos/open-collective-light.svg",
      "dark": "/company-logos/open-collective-dark.svg"
    }
-  },
-  {
-    "name": "Super",
-    "url": "https://super.so",
-    "image": {
-      "light": "/company-logos/super-light.svg",
-      "dark": "/company-logos/super-dark.svg"
-    }
-  },
-  {
-    "name": "Noodle",
-    "url": "https://noodle.run/",
-    "image": {
-      "light": "/company-logos/noodle-light.svg",
-      "dark": "/company-logos/noodle-dark.svg"
-    }
  }
 ]
@@ -209,5 +209,24 @@
    ],
    "source": "https://github.com/shx08/strapi-lucide-icons",
    "documentation": "https://github.com/shx08/strapi-lucide-icons/blob/main/README.md"
+  },
+  {
+    "name": "lucide-lit",
+    "description": "Implementation of Lucide icons as Lit web components.",
+    "icon": "/framework-logos/lit.svg",
+    "shields": [
+      {
+        "alt": "Latest Stable Version",
+        "src": "https://img.shields.io/npm/v/@gyeonghokim/lucide-lit",
+        "href": "https://www.npmjs.com/package/@gyeonghokim/lucide-lit"
+      },
+      {
+        "alt": "Total Downloads",
+        "src": "https://img.shields.io/npm/dw/@gyeonghokim/lucide-lit",
+        "href": "https://www.npmjs.com/package/@gyeonghokim/lucide-lit"
+      }
+    ],
+    "source": "https://github.com/GyeongHoKim/lucide-lit",
+    "documentation": "https://github.com/GyeongHoKim/lucide-lit/blob/main/README.md"
  }
 ]
@@ -24,13 +24,6 @@ const getHeadConfig = ({
      defer: '',
    },
  ],
-  [
-    'script',
-    {
-      src: 'https://media.bitterbrains.com/main.js?from=LUCIDE&type=top',
-      async: 'true',
-    },
-  ],
  [
    'meta',
    {
@@ -72,6 +72,11 @@ export const reactNativeSidebar = [
        link: '/guide/react-native/advanced/combining-icons',
        desc: 'Combine multiple icons into one',
      },
+      {
+        text: 'Optimizations',
+        link: '/guide/react-native/advanced/optimizations',
+        desc: 'Optimizing your app for performance',
+      },
    ],
  },
  {
@@ -11,6 +11,14 @@ const { isDark } = useData();

 const emit = defineEmits(['update:modelValue']);

+function limitHexInput(val: string) {
+  if (val.startsWith('#')) {
+    return val.slice(0, 9);
+  }
+
+  return val.slice(0, 8);
+}
+
 const value = computed({
  get: () => {
    if (props.modelValue == null || props.modelValue === 'currentColor') {
@@ -19,7 +27,7 @@ const value = computed({

    return props.modelValue;
  },
-  set: (val) => emit('update:modelValue', val),
+  set: (val) => emit('update:modelValue', limitHexInput(val)),
 });
 </script>

@@ -41,6 +49,7 @@ const value = computed({
      class="color-input-text"
      aria-label="Color picker input"
      v-model="value"
+      maxlength="9"
      placeholder="[default]"
    />
  </div>
@@ -91,6 +100,7 @@ const value = computed({
  background: transparent;
  color: var(--vp-c-text-1);
  font-size: 13px;
+  font-family: var(--vp-font-family-mono);
  text-align: left;
  border-radius: 8px;
  cursor: text;
@@ -6,10 +6,10 @@ import SelectIcon from './SelectIcon.vue';

 defineProps<{
  id?: string;
-  items?: { name: string; route: string; icon: string; iconDark?: string }[];
+  items?: { name: string; value: string; icon?: string; iconDark?: string }[];
 }>();

-const selected = defineModel<{ name: string; icon: string; iconDark?: string }>();
+const selected = defineModel<{ name: string; value: string; icon?: string; iconDark?: string }>();
 </script>

 <template>
@@ -19,14 +19,18 @@ const selected = defineModel<{ name: string; icon: string; iconDark?: string }>(
        class="select-button"
        :id="id"
      >
-        <SelectIcon :item="selected" />
+        <slot name="start-icon">
+          <SelectIcon  v-if="selected.icon" :item="selected" />
+        </slot>
        <span class="select-text">{{ selected.name }}</span>
        <span class="select-icon">
-          <Icon
-            :iconNode="chevronsUpDown"
-            class="chevron-icon"
-            aria-hidden="true"
-          />
+          <slot name="end-icon">
+            <Icon
+              :iconNode="chevronsUpDown"
+              class="chevron-icon"
+              aria-hidden="true"
+            />
+          </slot>
        </span>
      </ListboxButton>

@@ -43,8 +47,9 @@ const selected = defineModel<{ name: string; icon: string; iconDark?: string }>(
            :value="item"
            as="template"
          >
+
            <li :class="['select-option', { active, selected }]">
-              <SelectIcon :item="item" />
+              <SelectIcon v-if="item.icon" :item="item" />
              <span :class="['option-text', { selected }]">{{ item.name }}</span>
              <span
                v-if="selected"
@@ -2,25 +2,28 @@
 const { item } = defineProps<{
  item: {
    name: string;
-    icon: string;
+    icon?: string;
    iconDark?: string;
  };
 }>();
 </script>

 <template>
-  <img
-    :src="item.icon"
-    :class="{ 'select-item-icon': true, light: item.iconDark }"
-    :alt="`${item.name} logo`"
-    loading="lazy"
-  />
-  <img
-    v-if="item.iconDark"
-    :src="item.iconDark"
-    :alt="`${item.name} logo`"
-    class="select-item-icon dark"
-  />
+  <div v-if="item.icon || item.iconDark">
+    <img
+      v-if="item.icon"
+      :src="item.icon"
+      :class="{ 'select-item-icon': true, light: item.iconDark }"
+      :alt="`${item.name} logo`"
+      loading="lazy"
+    />
+    <img
+      v-if="item.iconDark"
+      :src="item.iconDark"
+      :alt="`${item.name} logo`"
+      class="select-item-icon dark"
+    />
+  </div>
 </template>

 <style scoped>
@@ -1,90 +0,0 @@
-<script setup lang="ts">
-import { useRouter } from 'vitepress';
-import { computed } from 'vue';
-
-const router = useRouter();
-
-const frameworks = [
-  {
-    ariaLabel: 'Get JavaScript certificates from certificates.dev',
-    image: '/certificates-dev/js-certificates-dev.jpg',
-    href: 'https://certificates.dev/javascript?friend=LUCIDE',
-    routes: [
-      '/guide/lucide/',
-      '/guide/svelte/',
-      '/guide/solid/',
-      '/guide/astro/',
-      '/guide/static/'
-    ],
-  },
-  {
-    ariaLabel: 'Get React certificates from certificates.dev',
-    image: '/certificates-dev/react-certificates-dev.jpg',
-    href: 'https://certificates.dev/react?friend=LUCIDE',
-    routes: [
-      '/guide/react/',
-      '/guide/react-native/',
-      '/guide/preact/',
-    ],
-  },
-  {
-    ariaLabel: 'Get Vue certificates from certificates.dev',
-    href: 'https://certificates.dev/vuejs?friend=LUCIDE',
-    image: '/certificates-dev/vue-certificates-dev.jpg',
-    routes: [
-      '/guide/vue/',
-    ],
-  },
-  {
-    ariaLabel: 'Get Angular certificates from certificates.dev',
-    href: 'https://certificates.dev/angular?friend=LUCIDE',
-    image: '/certificates-dev/angular-certificates-dev.jpg',
-    routes: [
-      '/guide/angular/',
-    ],
-  }
-];
-
-const selected = computed(() => {
-  const current = frameworks.find(({ routes }) => {
-    return routes.some(route => router.route.path.startsWith(route));
-  });
-
-  return current || frameworks[0];
-});
-</script>
-
-<template>
-  <a class="certificates-link" :href="selected.href" :aria-label="selected.ariaLabel" target="_blank" rel="noopener noreferrer">
-    <img :src="selected.image" :alt="selected.ariaLabel" />
-  </a>
-</template>
-
-<style scoped>
-.certificates-link {
-  /* padding: 20px; */
-  border-radius: 12px;
-  min-height: 100px;
-  text-align: center;
-  line-height: 18px;
-  font-size: 12px;
-  font-weight: 500;
-  background-color: var(--vp-carbon-ads-bg-color);
-  margin-bottom: 20px;
-  overflow: hidden;
-}
-
-.certificates-link img {
-  width: 100%;
-  height: 100%;
-  max-width: 100%;
-  border-radius: 6px;
-  transition: transform 0.3s ease, opacity 0.3s ease;
-}
-
-.certificates-link:hover img {
-  transform: scale(1.05);
-  opacity: 0.9;
-
-}
-</style>
@@ -11,49 +11,49 @@ const { page } = useData();
 const router = useRouter();

 const frameworks = [
-  { name: 'Vanilla', icon: '/framework-logos/js.svg', route: '/guide/lucide/' },
-  { name: 'React', icon: '/framework-logos/react.svg', route: '/guide/react/' },
-  { name: 'Vue', icon: '/framework-logos/vue.svg', route: '/guide/vue/' },
-  { name: 'Svelte', icon: '/framework-logos/svelte.svg', route: '/guide/svelte/' },
-  { name: 'Solid', icon: '/framework-logos/solid.svg', route: '/guide/solid/' },
-  { name: 'Angular', icon: '/framework-logos/angular.svg', route: '/guide/angular/' },
-  { name: 'Preact', icon: '/framework-logos/preact.svg', route: '/guide/preact/' },
+  { name: 'Vanilla', icon: '/framework-logos/js.svg', value: '/guide/lucide/' },
+  { name: 'React', icon: '/framework-logos/react.svg', value: '/guide/react/' },
+  { name: 'Vue', icon: '/framework-logos/vue.svg', value: '/guide/vue/' },
+  { name: 'Svelte', icon: '/framework-logos/svelte.svg', value: '/guide/svelte/' },
+  { name: 'Solid', icon: '/framework-logos/solid.svg', value: '/guide/solid/' },
+  { name: 'Angular', icon: '/framework-logos/angular.svg', value: '/guide/angular/' },
+  { name: 'Preact', icon: '/framework-logos/preact.svg', value: '/guide/preact/' },
  {
    name: 'React Native',
    icon: '/framework-logos/react-native.svg',
-    route: '/guide/react-native/',
+    value: '/guide/react-native/',
  },
  {
    name: 'Astro',
    icon: '/framework-logos/astro.svg',
    iconDark: '/framework-logos/astro-dark.svg',
-    route: '/guide/astro/',
+    value: '/guide/astro/',
  },
-  { name: 'Static', icon: '/framework-logos/svg.svg', route: '/guide/static/' },
+  { name: 'Static', icon: '/framework-logos/svg.svg', value: '/guide/static/' },
 ];

 const fallbackFramework = useLocalStorage('lucide-docs-fallback-framework', frameworks[1]);

 const selected = computed(() => {
-  const current = frameworks.find(({ route }) => {
+  const current = frameworks.find(({ value }) => {
    if (router.route.path?.startsWith?.('/guide')) {
      const [, , framework] = router.route.path.split('/');
-      const [, frameWorkRoute] = route.split('/').filter(Boolean);
+      const [, frameWorkRoute] = value.split('/').filter(Boolean);

      return framework === frameWorkRoute;
    }
-    return router.route.path.split('/').slice(0, 3).join('/') === route;
+    return router.route.path.split('/').slice(0, 3).join('/') === value;
  });

-  return current || fallbackFramework.value;
+  return current || (fallbackFramework.value?.value ? fallbackFramework.value : frameworks[0]);
 });

-function onSelectFramework(item: { name: string; icon: string; iconDark?: string; route: string }) {
+function onSelectFramework(item: { name: string; icon: string; iconDark?: string; value: string }) {
  fallbackFramework.value = item;
-  if (item.route !== router.route.path) {
-    const likeRoute = router.route.path.replace(selected.value.route, item.route);
+  if (item.value !== router.route.path) {
+    const likeRoute = router.route.path.replace(selected.value.value, item.value);

-    const hasRoute = sidebar[item.route]?.some((section) =>
+    const hasRoute = sidebar[item.value]?.some((section) =>
      section?.items?.some(({ link }) => link === likeRoute),
    );

@@ -62,7 +62,7 @@ function onSelectFramework(item: { name: string; icon: string; iconDark?: string
      return;
    }

-    router.go(item.route);
+    router.go(item.value);
  }
 }
 </script>
@@ -85,12 +85,12 @@ function onSelectFramework(item: { name: string; icon: string; iconDark?: string
    />
  </div>
  <VPSidebarGroup
-    :key="selected.route"
+    :key="selected.value"
    v-if="
      page?.relativePath?.startsWith?.('guide') &&
-      !page?.relativePath?.startsWith?.(selected.route.substring(1))
+      !page?.relativePath?.startsWith?.(selected.value.substring(1))
    "
-    :items="sidebar[selected.route]"
+    :items="sidebar[selected.value]"
  />
 </template>

@@ -13,23 +13,21 @@ const { go } = useRouter()
    <HomeSectionTitle>Available For:</HomeSectionTitle>
    <div class="packages-list">
      <a
-        v-for="{ name, logo, logoDark } in data.packages"
-        :href="`/guide/packages/${name}`"
+        v-for="{ name, label, path, logo, logoDark } in data.packages"
+        :href="path"
        class="package-logo"
-        :aria-label="`Read more about: ${name} package`"
-        @click.prevent="go(`/guide/packages/${name}`)"
+        @click.prevent="go(path)"
      >
        <img
          :src="logo"
          :class="{ light: logoDark, 'image-logo': true }"
-          :alt="`${name} logo`"
+          :alt="label"
          loading="lazy"
        />
-
        <img
          v-if="logoDark"
          :src="logoDark"
-          :alt="`${name} logo`"
+          :alt="label"
          class="image-logo dark"
          loading="lazy"
        />
@@ -188,7 +188,7 @@ const deprecatedTitle = computed(() => {
  -ms-overflow-style: none;
  scrollbar-width: none;
  scrollbar-width: thin; /* can also be normal, or none, to not render scrollbar */
-  scrollbar-color: currentColor transparent; /* foreground background */
+  scrollbar-color: var(--vp-c-text-4) transparent; /* foreground background */
 }
 .horizontal-scroller::-webkit-scrollbar {
  width: 0;
@@ -3,6 +3,7 @@ import type { IconEntity } from '../../types';
 import { computed, ref } from 'vue';
 import createLucideIcon from '@lucide/vue/src/createLucideIcon';
 import { useIconStyleContext } from '../../composables/useIconStyle';
+import { squarePen } from '../../../data/iconNodes';

 const props = defineProps<{
  name: IconEntity['name'];
@@ -19,6 +20,31 @@ const iconComponent = computed(() => {
  if (!props.name || !props.iconNode) return null;
  return createLucideIcon(props.name, props.iconNode);
 });
+
+const SquarePenIcon = createLucideIcon('SquarePen', squarePen);
+
+const innerSvg = computed(() => {
+  if (!props.iconNode) return '';
+
+  const string = props.iconNode
+    .map(([tag, attrs]) => {
+      const attributes = Object.entries(attrs)
+        .map(([key, value]) => `${key}="${value}"`)
+        .join(' ');
+      return `<${tag} ${attributes}/>`;
+    })
+    .join('');
+
+  return string
+    .replace(/>[\r\n ]+</g, '><')
+    .replace(/(<.*?>)|\s+/g, (m, $1) => $1 || ' ')
+    .trim();
+});
+
+const base64InnerSvg = computed(() => {
+  if (typeof window === 'undefined') return '';
+  return btoa(innerSvg.value);
+});
 </script>

 <template>
@@ -57,6 +83,16 @@ const iconComponent = computed(() => {
        />
      </g>
    </svg>
+    <a
+      :href="`https://studio.lucide.dev/edit?value=${encodeURIComponent(base64InnerSvg)}&name=${name}&utm_source=lucide.dev&utm_medium=icon-detail-preview`"
+      target="_blank"
+      rel="noopener noreferrer"
+      class="studio-button"
+      title="Open in Lucide Studio"
+      aria-label="Open in Lucide Studio"
+    >
+      <SquarePenIcon :size="14" />
+    </a>
  </div>
 </template>

@@ -75,6 +111,8 @@ const iconComponent = computed(() => {
  position: relative;
  background: var(--vp-c-bg-alt);
  border-radius: 8px;
+  overflow: hidden;
+  flex-shrink: 0;
 }
 .icon-container > :deep(svg:not(.icon-grid)) {
  width: 100%;
@@ -85,6 +123,34 @@ const iconComponent = computed(() => {
  opacity: 0.8;
 }

+.studio-button {
+  position: absolute;
+  bottom: 8px;
+  right: 8px;
+  background: var(--vp-c-bg);
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 6px;
+  padding: 5px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  color: var(--vp-c-text-2);
+  opacity: 0;
+  transition: opacity 0.2s, color 0.2s, background-color 0.2s;
+  z-index: 2;
+}
+
+.icon-container:hover .studio-button,
+.studio-button:focus-visible {
+  opacity: 1;
+}
+
+.studio-button:hover,
+.studio-button:focus-visible {
+  background: var(--vp-c-bg-soft);
+  color: var(--vp-c-text-1);
+}
+
 .icon-component.customizable {
  will-change: width, height, stroke-width, stroke;
  /* color: var(--customize-color, currentColor);
@@ -44,8 +44,12 @@ function setActiveIconName(name: string) {
  activeIconName.value = name;
 }

-const { execute: fetchTags, data: tags } = useFetchTags();
-const { execute: fetchCategories, data: categoriesMap } = useFetchCategories();
+const { execute: fetchTags, data: tags, isFetching: isFetchingTags } = useFetchTags();
+const {
+  execute: fetchCategories,
+  data: categoriesMap,
+  isFetching: isFetchingCategories,
+} = useFetchCategories();

 const overviewEl = ref<HTMLElement | null>(null);
 const { width: containerWidth } = useElementSize(overviewEl);
@@ -117,6 +121,9 @@ const categoriesList = computed(() => {
    }, []);
 });
 const searchPlaceholder = useSearchPlaceholder(searchQuery, searchResults);
+const isSearchMetadataLoading = computed(
+  () => searchQuery.value.length > 0 && (tags.value == null || categoriesMap.value == null),
+);

 const { list, containerProps, wrapperProps, scrollTo } = useVirtualList(categoriesList, {
  itemHeight: ICON_SIZE + ICON_GRID_GAP,
@@ -135,15 +142,21 @@ onMounted(() => {
  useEventListener(window, 'scroll', containerProps.onScroll);
 });

-function onFocusSearchInput() {
-  if (tags.value == null) {
-    fetchTags();
+function loadSearchMetadata() {
+  if (tags.value == null && !isFetchingTags.value) {
+    void fetchTags();
  }
-  if (categoriesMap.value == null) {
-    fetchCategories();
+  if (categoriesMap.value == null && !isFetchingCategories.value) {
+    void fetchCategories();
  }
 }

+watch(searchQuery, (searchString) => {
+  if (searchString !== '') {
+    loadSearchMetadata();
+  }
+});
+
 const NoResults = defineAsyncComponent(() => import('./NoResults.vue'));
 const IconDetailOverlay = defineAsyncComponent(() => import('./IconDetailOverlay.vue'));

@@ -156,11 +169,11 @@ function handleCloseDrawer() {
  if (searchQueryDebounced.value) {
    url.searchParams.set('search', searchQueryDebounced.value);
  }
-  
+
  if (selectedCategory.value) {
    url.hash = selectedCategory.value;
  }
-  
+
  window.history.pushState({}, '', url);
 }
 </script>
@@ -169,6 +182,7 @@ function handleCloseDrawer() {
  <div
    ref="overviewEl"
    class="overview-container"
+    :class="{ 'icon-drawer-open': activeIconName }"
  >
    <StickyBar class="category-search">
      <InputSearch
@@ -177,11 +191,11 @@ function handleCloseDrawer() {
        :shortcut="kbdSearchShortcut"
        class="input-wrapper"
        ref="searchInput"
-        @focus="onFocusSearchInput"
+        @focus="loadSearchMetadata"
      />
    </StickyBar>
    <NoResults
-      v-if="searchPlaceholder.isNoResults"
+      v-if="searchPlaceholder.isNoResults && !isSearchMetadataLoading"
      :searchQuery="searchPlaceholder.query"
      :isBrandSearch="searchPlaceholder.isBrand"
      @clear="searchQuery = ''"
@@ -4,6 +4,7 @@ import type { IconEntity } from '../../types';
 import { useElementSize, useEventListener, useVirtualList } from '@vueuse/core';
 import { useRoute } from 'vitepress';
 import IconGrid from './IconGrid.vue';
+import Select from '../base/Select.vue';
 import InputSearch from '../base/InputSearch.vue';
 import useSearch from '../../composables/useSearch';
 import useSearchInput from '../../composables/useSearchInput';
@@ -14,9 +15,26 @@ import useFetchCategories from '../../composables/useFetchCategories';
 import chunkArray from '../../utils/chunkArray';
 import CarbonAdOverlay from './CarbonAdOverlay.vue';
 import useSearchPlaceholder from '../../utils/useSearchPlaceholder.ts';
+import Icon from '@lucide/vue/src/Icon';
+import { listSortDescending } from '~/.vitepress/data/iconNodes';

 const ICON_SIZE = 56;
 const ICON_GRID_GAP = 8;
+const SORTING = [
+  {
+    name: 'Popularity',
+    value: 'popularity',
+  },
+  {
+    name: 'Release date',
+    value: 'release-date',
+  },
+  {
+    name: 'Name',
+    value: 'name',
+  },
+]
+

 const initialGridItems = computed(() => {
  if (containerWidth.value === 0) return 120;
@@ -32,9 +50,14 @@ const props = defineProps<{
 }>();

 const activeIconName = ref(null);
+const selectedSort = ref(SORTING[0])

-const { execute: fetchTags, data: tags } = useFetchTags();
-const { execute: fetchCategories, data: categories } = useFetchCategories();
+const { execute: fetchTags, data: tags, isFetching: isFetchingTags } = useFetchTags();
+const {
+  execute: fetchCategories,
+  data: categories,
+  isFetching: isFetchingCategories,
+} = useFetchCategories();

 const overviewEl = ref<HTMLElement | null>(null);
 const { width: containerWidth } = useElementSize(overviewEl);
@@ -43,12 +66,29 @@ const columnSize = computed(() => {
  return Math.floor(containerWidth.value / (ICON_SIZE + ICON_GRID_GAP));
 });

+const sortedIcons = computed(() => {
+  switch (selectedSort.value.value) {
+    case 'popularity':
+      return [...props.icons].sort((a, b) => (b.popularity || 0) - (a.popularity || 0));
+    case 'release-date':
+      return [...props.icons].sort((a, b) => {
+        const aDate = a.createdRelease?.date ? new Date(a.createdRelease.date).getTime() : 0;
+        const bDate = b.createdRelease?.date ? new Date(b.createdRelease.date).getTime() : 0;
+        return bDate - aDate;
+      });
+    case 'name':
+      return [...props.icons].sort((a, b) => a.name.localeCompare(b.name));
+    default:
+      return props.icons;
+  }
+});
+
 const mappedIcons = computed(() => {
  if (tags.value == null) {
-    return props.icons;
+    return sortedIcons.value;
  }

-  return props.icons.map((icon) => {
+  return sortedIcons.value.map((icon) => {
    const iconTags = tags.value[icon.name];
    const iconCategories = categories.value?.[icon.name] ?? [];

@@ -68,11 +108,15 @@ const { shortcutText: kbdSearchShortcut } = useSearchShortcut(() => {

 const searchResults = useSearch(searchQueryDebounced, mappedIcons, [
  { name: 'name', weight: 3 },
-  { name: 'aliases', weight: 3 },
+  { name: 'aliases', weight: 8 },
  { name: 'tags', weight: 2 },
  { name: 'categories', weight: 1 },
 ]);
+
 const searchPlaceholder = useSearchPlaceholder(searchQuery, searchResults);
+const isSearchMetadataLoading = computed(
+  () => searchQuery.value.length > 0 && (tags.value == null || categories.value == null),
+);

 const chunkedIcons = computed(() => {
  return chunkArray(searchResults.value, columnSize.value);
@@ -98,15 +142,21 @@ function setActiveIconName(name: string) {
  activeIconName.value = name;
 }

-function onFocusSearchInput() {
-  if (tags.value == null) {
-    fetchTags();
+function loadSearchMetadata() {
+  if (tags.value == null && !isFetchingTags.value) {
+    void fetchTags();
  }
-  if (categories.value == null) {
-    fetchCategories();
+  if (categories.value == null && !isFetchingCategories.value) {
+    void fetchCategories();
  }
 }

+watch(searchQuery, (searchString) => {
+  if (searchString !== '') {
+    loadSearchMetadata();
+  }
+});
+
 const NoResults = defineAsyncComponent(() => import('./NoResults.vue'));

 const IconDetailOverlay = defineAsyncComponent(() => import('./IconDetailOverlay.vue'));
@@ -124,7 +174,7 @@ function handleCloseDrawer() {
  if (searchQueryDebounced.value) {
    url.searchParams.set('search', searchQueryDebounced.value);
  }
-  
+
  window.history.pushState({}, '', url);
 }
 </script>
@@ -133,6 +183,7 @@ function handleCloseDrawer() {
  <div
    ref="overviewEl"
    class="overview-container"
+    :class="{ 'icon-drawer-open': activeIconName }"
  >
    <StickyBar>
      <InputSearch
@@ -141,11 +192,25 @@ function handleCloseDrawer() {
        ref="searchInput"
        :shortcut="kbdSearchShortcut"
        class="input-wrapper"
-        @focus="onFocusSearchInput"
+        @focus="loadSearchMetadata"
      />
+
+      <Select
+        id="sort-select"
+        :items="SORTING"
+        v-model="selectedSort"
+      >
+        <template #start-icon>
+          <Icon
+            :iconNode="listSortDescending"
+            class="chevron-icon"
+            aria-hidden="true"
+          />
+        </template>
+      </Select>
    </StickyBar>
    <NoResults
-      v-if="searchPlaceholder.isNoResults"
+      v-if="searchPlaceholder.isNoResults && !isSearchMetadataLoading"
      :searchQuery="searchPlaceholder.query"
      :isBrandSearch="searchPlaceholder.isBrand"
      @clear="searchQuery = ''"
@@ -73,13 +73,11 @@ const customizingActive = computed(() => {
      id="icon-color"
      label="Color"
    >
-      <template #display>
-        <ColorPicker
-          v-model="color"
-          id="icon-color"
-          class="color-picker"
-        />
-      </template>
+      <ColorPicker
+        v-model="color"
+        id="icon-color"
+        class="color-picker"
+      />
    </InputField>

    <InputField
@@ -161,6 +159,6 @@ const customizingActive = computed(() => {
 }

 .color-picker {
-  margin-left: auto;
+  width: 100%;
 }
 </style>
@@ -15,6 +15,50 @@
  margin-bottom: 32px;
  background: var(--vp-c-bg);
  box-shadow: 0 16px 24px var(--vp-c-bg);
+  gap: 16px;
+}
+
+.search-bar :deep(.select-button) {
+  padding: 11px 14px;
+  background-color: var(--vp-c-bg-alt);
+  color: var(--vp-c-text-2);
+  flex-shrink: 0;
+  flex: 1;
+  font-weight: 500;
+  cursor: pointer;
+}
+
+.search-bar :deep(.select-button):hover,
+.search-bar :deep(.select-button):focus {
+  border-color: var(--vp-c-brand);
+  background: var(--vp-c-bg-alt);
+}
+
+.search-bar :deep(.select-options) {
+  min-width: 160px;
+}
+
+.search-bar :deep(.select-option) {
+  padding-right: 36px;
+  padding-left: 8px;
+}
+
+.search-bar :deep(.select-icon) {
+  display: none;
+}
+
+.search-bar :deep(.select-button) .select-text {
+  display: none;
+}
+
+@media (min-width: 640px) {
+  .search-bar :deep(.select-button) {
+    padding: 11px 16px 11px 16px;
+  }
+
+  .search-bar :deep(.select-button) .select-text {
+    display: block;
+  }
 }

@media (min-width: 960px) {
@@ -16,7 +16,7 @@ export const externalLibContext = {
 };

 const externalLibIconNodesAPI = {
-  lab: 'https://lab.lucide.dev/api/icon-details',
+  lab: `${import.meta.env.DEV ? 'http://localhost:3000' : ''}/api/lab/icon-details`,
 };

 export function useExternalLibs(): ExternalLibContext {
@@ -32,13 +32,15 @@ export function useExternalLibs(): ExternalLibContext {
          newExternalIconNodes[lib] = savedIconNodes[lib];
        } else {
          const response = await fetch(externalLibIconNodesAPI[lib]);
-          const iconNodes = await response.json();
+          const iconDetails = await response.json();

-          if (iconNodes) {
-            newExternalIconNodes[lib] = Object.values(iconNodes).map((iconEntity: IconEntity) => ({
-              ...iconEntity,
-              externalLibrary: lib,
-            }));
+          if (iconDetails) {
+            newExternalIconNodes[lib] = Object.values(iconDetails).map((iconEntity: IconEntity) => {
+              return {
+                ...iconEntity,
+                externalLibrary: lib,
+              };
+            });
          }
        }
      }
@@ -20,16 +20,6 @@ const useSearch = <T>(
      return index.value.search(query.value).map((result) => result.item);
    }

-    if (keys.length !== 0) {
-      const mainKey = keys[0].name;
-
-      return collection.value.sort((a, b) => {
-        const aString = a[mainKey as keyof T] as string;
-        const bString = b[mainKey as keyof T] as string;
-        return aString.localeCompare(bString);
-      });
-    }
-
    return collection.value;
  });

@@ -12,7 +12,6 @@ import { CATEGORY_VIEW_CONTEXT, categoryViewContext } from './composables/useCat
 import { EXTERNAL_LIBS_CONTEXT, externalLibContext } from './composables/useExternalLibs';
 import FrameworkSelect from './components/guide/FrameworkSelect.vue';
 import SnackPlayer from './components/editors/SnackPlayer.vue';
-import CertificatesLink from './components/guide/CertificatesLink.vue';

 const theme: Partial<Theme> = {
  extends: DefaultTheme,
@@ -23,7 +22,6 @@ const theme: Partial<Theme> = {
      'sidebar-nav-after': () => h(IconsSidebarNavAfter),
      'home-hero-image': () => h(HomeHeroIconsCard),
      'home-hero-actions-after': () => h(HomeHeroAfter),
-      'aside-ads-before': () => h(CertificatesLink),
      // Keep this here for now, we might want to add more things to the top bar in the future
      // 'layout-top': () => h(LayoutTop),
    });
@@ -67,6 +67,10 @@
  animation: .3s transition 0s ease;
 } */

+html {
+  scrollbar-gutter: stable;
+}
+
 .VPHome {
  overflow-x: hidden;
 }
@@ -117,6 +121,10 @@
  padding-left: 0;
 }

+.overview-container.icon-drawer-open {
+  padding-bottom: 288px;
+}
+
 .VPHomeHero .container {
  flex-direction: column-reverse;
 }
@@ -144,14 +152,6 @@
  .VPHomeHero .container {
    flex-direction: row;
  }
-
-  html.has-bb-banner {
-    --vp-layout-top-height: 72px;
-  }
-
-  html.has-bb-banner {
-    --Dark-Background: #161618;
-  }
 }

 .VPNavBarHamburger .container > span {
@@ -163,8 +163,23 @@
  max-width: 480px;
 }

-html:not(.has-bb-banner) #bb-banner {
-  display: none !important;
-  visibility: hidden !important;
-  pointer-events: none !important;
+.VPSidebar {
+  /* Hide Scrollbar */
+  -ms-overflow-style: none;
+  scrollbar-width: none;
+  scrollbar-width: thin; /* can also be normal, or none, to not render scrollbar */
+  scrollbar-color: var(--vp-c-text-4) transparent; /* foreground background */
+}
+.VPSidebar::-webkit-scrollbar {
+  width: 0;
+  display: none;
+}
+
+.VPSidebar::-webkit-scrollbar-track {
+  background: transparent;
+}
+
+.VPSidebar::-webkit-scrollbar-thumb {
+  background: transparent;
+  border: none;
 }
@@ -18,6 +18,7 @@ export interface IconEntity extends IconMetaData {
  externalLibrary?: ExternalLibs;
  createdRelease?: Release;
  changedRelease?: Release;
+  popularity?: number;
 }

 export interface Category {
@@ -1,4 +1,4 @@
-import { PageData } from 'vitepress';
+import { type PageData } from 'vitepress';
 import getStructuredData from './getStructuredData';
 import { createGeneralOGImage, createIconOGImage } from './createOGImage';

@@ -158,7 +158,7 @@ For each icon these attributes are applied, corresponding to the above rules.
 ### Minify paths

 The code of paths can sometimes get quite large. To reduce file size we like to minify the code.
-We recommend to use [Lucide Studio](https://studio.lucide.dev/) to tidy paths to 3 points of precision.
+We recommend to use [Lucide Studio](https://studio.lucide.dev/?utm_source=lucide.dev&utm_medium=design-guide) to tidy paths to 3 points of precision.

 ### Allowed elements

@@ -12,6 +12,10 @@ import Sandpack from '~/.vitepress/theme/components/editors/SandpackAngular.vue'

 While they aren't provided as standalone components, they can be still be passed to the `LucideIcon` component the same way as official icons:

+::: info Limitation
+Only custom icons that follow Lucide's [code conventions](../../../contribute/icon-design-guide.md#code-conventions) are supported.
+:::
+
 ### Directly as LucideIconData

 ::: sandpack {template=angular showTabs=false editorHeight=400 editorWidthPercentage=60 dependencies="@lucide/angular,@lucide/lab"}
@@ -12,19 +12,23 @@ Implementation of the Lucide icon library for web applications.
 ::: code-group

 ```sh [pnpm]
-pnpm add lucide@next
+pnpm add lucide
 ```

 ```sh [yarn]
-yarn add lucide@next
+yarn add lucide
 ```

 ```sh [npm]
-npm install lucide@next
+npm install lucide
 ```

 ```sh [bun]
-bun add lucide@next
+bun add lucide
+```
+
+```sh [deno]
+deno add lucide
 ```

 :::
@@ -38,19 +42,23 @@ Implementation of the Lucide icon library for React applications.
 ::: code-group

 ```sh [pnpm]
-pnpm add lucide-react@next
+pnpm add lucide-react
 ```

 ```sh [yarn]
-yarn add lucide-react@next
+yarn add lucide-react
 ```

 ```sh [npm]
-npm install lucide-react@next
+npm install lucide-react
 ```

 ```sh [bun]
-bun add lucide-react@next
+bun add lucide-react
+```
+
+```sh [deno]
+deno add lucide-react
 ```

 :::
@@ -80,6 +88,10 @@ npm install @lucide/vue
 bun add @lucide/vue
 ```

+```sh [deno]
+deno add @lucide/vue
+```
+
 :::

 For more details, see the [documentation](./vue/index.md).
@@ -91,19 +103,23 @@ Implementation of the Lucide icon library for Svelte applications.
 ::: code-group

 ```sh [pnpm]
-pnpm add @lucide/svelte@next
+pnpm add @lucide/svelte
 ```

 ```sh [yarn]
-yarn add @lucide/svelte@next
+yarn add @lucide/svelte
 ```

 ```sh [npm]
-npm install @lucide/svelte@next
+npm install @lucide/svelte
 ```

 ```sh [bun]
-bun add @lucide/svelte@next
+bun add @lucide/svelte
+```
+
+```sh [deno]
+deno add @lucide/svelte
 ```
 :::
 > `@lucide/svelte` is only for Svelte 5, for Svelte 4 use the `lucide-svelte` package.
@@ -117,19 +133,23 @@ Implementation of the Lucide icon library for Solid applications.
 ::: code-group

 ```sh [pnpm]
-pnpm add lucide-solid@next
+pnpm add lucide-solid
 ```

 ```sh [yarn]
-yarn add lucide-solid@next
+yarn add lucide-solid
 ```

 ```sh [npm]
-npm install lucide-solid@next
+npm install lucide-solid
 ```

 ```sh [bun]
-bun add lucide-solid@next
+bun add lucide-solid
+```
+
+```sh [deno]
+deno add lucide-solid
 ```

 :::
@@ -158,6 +178,10 @@ npm install @lucide/angular
 bun add @lucide/angular
 ```

+```sh [deno]
+deno add @lucide/angular
+```
+
 :::

 For more details, see the [documentation](./angular/index.md).
@@ -169,19 +193,23 @@ Implementation of the Lucide icon library for preact applications.
 ::: code-group

 ```sh [pnpm]
-pnpm add lucide-preact@next
+pnpm add lucide-preact
 ```

 ```sh [yarn]
-yarn add lucide-preact@next
+yarn add lucide-preact
 ```

 ```sh [npm]
-npm install lucide-preact@next
+npm install lucide-preact
 ```

 ```sh [bun]
-bun add lucide-preact@next
+bun add lucide-preact
+```
+
+```sh [deno]
+deno add lucide-preact
 ```


@@ -196,19 +224,23 @@ Implementation of the Lucide icon library for Astro applications.
 ::: code-group

 ```sh [pnpm]
-pnpm add @lucide/astro@next
+pnpm add @lucide/astro
 ```

 ```sh [yarn]
-yarn add @lucide/astro@next
+yarn add @lucide/astro
 ```

 ```sh [npm]
-npm install @lucide/astro@next
+npm install @lucide/astro
 ```

 ```sh [bun]
-bun add @lucide/astro@next
+bun add @lucide/astro
+```
+
+```sh [deno]
+deno add @lucide/astro
 ```

 :::
@@ -222,19 +254,23 @@ Implementation of the Lucide icon library for multiple usages that like to use:
 ::: code-group

 ```sh [pnpm]
-pnpm add lucide-static@next
+pnpm add lucide-static
 ```

 ```sh [yarn]
-yarn add lucide-static@next
+yarn add lucide-static
 ```

 ```sh [npm]
-npm install lucide-static@next
+npm install lucide-static
 ```

 ```sh [bun]
-bun add lucide-static@next
+bun add lucide-static
+```
+
+```sh [deno]
+deno add lucide-static
 ```

 :::
@@ -0,0 +1,56 @@
+---
+title: Optimizations - React Native
+description: Learn how to optimize the bundle size of your React Native and Expo web exports by tree-shaking Lucide icons.
+---
+
+# Optimizations
+
+By default you import icons from the `lucide-react-native` entry point:
+
+```jsx
+import { Camera } from 'lucide-react-native';
+```
+
+This is convenient, but it relies on the bundler to _tree-shake_ the entry point (a "barrel" file that re-exports every icon) so that only the icons you actually use end up in your bundle.
+
+On native platforms this is usually fine. On **web exports** it can be a problem, because the Metro bundler is currently not very good at tree-shaking barrel imports and may include **all** icons in your final bundle.
+
+## The Metro tree-shaking limitation
+
+When you build for web with Expo (`expo export --platform web`), Metro is used to bundle your JavaScript. Metro bundles modules on-demand and, by default, does not remove unused exports from a barrel file.
+
+This means an import like the one below can pull in the entire icon set, even though only a single icon is rendered:
+
+```jsx
+// May bundle every Lucide icon on web exports
+import { Camera } from 'lucide-react-native';
+```
+
+Expo documents an experimental optimization for [React Native web imports](https://docs.expo.dev/guides/tree-shaking/#react-native-web-imports) and for [removing unused imports and exports](https://docs.expo.dev/guides/tree-shaking/#remove-unused-imports-and-exports). In practice this tree-shaking does **not** currently work reliably for `lucide-react-native` barrel imports, so the unused icons are not removed from web exports.
+
+## Recommended: import icons individually
+
+To guarantee that only the icons you use are bundled — regardless of the bundler's tree-shaking capabilities — import each icon directly from its own module:
+
+```jsx
+import Camera from 'lucide-react-native/icons/camera';
+
+// Usage
+const App = () => {
+  return <Camera />;
+};
+
+export default App;
+```
+
+Because each icon lives in its own file, the bundler only ever includes the icons you explicitly import. This keeps your web export small without depending on Metro's experimental tree-shaking.
+
+The icon module name is the [kebab-case](https://developer.mozilla.org/en-US/docs/Glossary/Kebab_case) version of the icon name. For example, the `ArrowRight` icon is imported from `lucide-react-native/icons/arrow-right`:
+
+```jsx
+import ArrowRight from 'lucide-react-native/icons/arrow-right';
+```
+
+::: tip
+Individual icon imports work identically on native and web, so you can safely use this style across your whole project to keep bundles as small as possible on every platform.
+:::
@@ -1,9 +1,19 @@
-import iconNodes from '../.vitepress/data/iconNodes';
+import * as iconDetails from '../.vitepress/data/iconDetails';

 export default {
  async load() {
    return {
-      icons: Object.entries(iconNodes).map(([name, iconNode]) => ({ name, iconNode })),
+      icons: Object.entries(iconDetails).map(
+        ([, { name, iconNode, popularity, createdRelease, aliases = [] }]) => ({
+          name,
+          iconNode,
+          popularity: popularity?.count ?? 0,
+          aliases: aliases
+            .map((alias) => (typeof alias === 'string' ? alias : alias?.name))
+            .filter((alias): alias is string => Boolean(alias)),
+          createdRelease,
+        }),
+      ),
    };
  },
 };
@@ -1,24 +1,26 @@
-import { IconEntity } from '../../.vitepress/theme/types';
+import iconNodes from '../../.vitepress/data/lab/iconNodes';
+import iconPopularity from '../../.vitepress/data/lab/iconPopularity';
+import iconMetaData from '../../.vitepress/data/lab/iconMetaData';
+import { type IconEntity } from '../../.vitepress/theme/types';

 export default {
  paths: async () => {
-    try {
-      const iconDetailsResponse = await fetch('https://lab.lucide.dev/api/icon-details');
-      const iconDetails = (await iconDetailsResponse.json()) as Record<string, IconEntity>;
+    return (Object.entries(iconNodes) as unknown as IconEntity[]).map(([name, iconNode]) => {
+      const iconDetails = iconMetaData[name];

-      return Object.values(iconDetails).map((iconEntity) => {
-        const params = {
-          externalLibrary: 'lab',
-          ...iconEntity,
-        };
+      delete iconDetails['$schema'];

-        return {
-          params,
-        };
-      });
-    } catch (error) {
-      console.error('Error fetching icon details:', error);
-      return [];
-    }
+      const params = {
+        name,
+        iconNode,
+        externalLibrary: 'lab',
+        popularity: iconPopularity[name]?.count ?? 0,
+        ...iconDetails,
+      };
+
+      return {
+        params,
+      };
+    });
  },
 };
@@ -8,18 +8,21 @@
    "docs:dev": "pnpm run /^prebuild:.*/ && vitepress dev",
    "docs:build": "pnpm run /^prebuild:.*/ && vitepress build",
    "docs:preview": "vitepress preview",
-    "build:docs": "vitepress build",
-    "prebuild:iconNodes": "node ./scripts/writeIconNodes.mjs",
-    "prebuild:metaJson": "node ./scripts/writeIconMetaIndex.mjs",
-    "prebuild:releaseJson": "node ./scripts/writeReleaseMetadata.mjs",
-    "prebuild:categoriesJson": "node ./scripts/writeCategoriesMetadata.mjs",
-    "prebuild:relatedIcons": "node ./scripts/writeIconRelatedIcons.mjs",
-    "prebuild:iconDetails": "node ./scripts/writeIconDetails.mjs",
-    "prebuild:brandStopwords": "node ./scripts/writeBrandStopwords.mjs",
-    "postbuild:vercelJson": "node ./scripts/writeVercelOutput.mjs",
-    "dev": "npx nitropack dev",
-    "prebuild:api": "npx nitropack prepare",
-    "build:api": "npx nitropack build",
+    "build:docs": "NODE_OPTIONS=--max-old-space-size=8192 vitepress build",
+    "prebuild:iconNodes": "node ./scripts/writeIconNodes.mts",
+    "prebuild:metaJson": "node ./scripts/writeIconMetaIndex.mts",
+    "prebuild:releaseJson": "node ./scripts/writeReleaseMetadata.mts",
+    "prebuild:categoriesJson": "node ./scripts/writeCategoriesMetadata.mts",
+    "prebuild:relatedIcons": "node ./scripts/writeIconRelatedIcons.mts",
+    "prebuild:iconDetails": "node ./scripts/writeIconDetails.mts",
+    "prebuild:iconPopularity": "node ./scripts/writeiconPopularity.mts && node ./scripts/writeiconPopularityIndex.mts",
+    "prebuild:brandStopwords": "node ./scripts/writeBrandStopwords.mts",
+    "prebuild:writeLabIconNodes": "node ./scripts/writeLabIconNodes.mts",
+    "prebuild:writeLabIconMetaIndex": "node ./scripts/writeLabIconMetaIndex.mts",
+    "postbuild:vercelJson": "node ./scripts/writeVercelOutput.mts",
+    "dev": "nitropack dev",
+    "prebuild:api": "nitropack prepare",
+    "build:api": "NODE_OPTIONS=--max-old-space-size=8192 nitropack build",
    "build": "pnpm run /^prebuild:.*/ && pnpm run build:api && pnpm run build:docs && pnpm postbuild:vercelJson",
    "preview": "node .output/server/index.mjs"
  },
@@ -31,31 +34,32 @@
    "@lucide/shared": "workspace:*",
    "@rollup/plugin-replace": "^6.0.3",
    "@types/semver": "^7.7.1",
-    "h3": "^1.15.9",
+    "h3": "^1.15.11",
+    "markdown-it": "^14.3.0",
+    "markdown-it-container": "^4.0.0",
    "nitropack": "^2.13.4",
    "rollup-plugin-copy": "^3.5.0",
-    "svg-path-commander": "^2.1.11",
-    "vitepress": "^1.6.4",
-    "vitepress-plugin-group-icons": "^1.6.5",
-    "vitepress-plugin-llms": "^1.11.1",
-    "markdown-it": "^14.1.0",
-    "markdown-it-container": "^4.0.0",
-    "semver": "^7.7.3",
+    "semver": "^7.8.5",
    "sharp": "^0.34.5",
-    "shiki": "^3.15.0",
+    "shiki": "^3.23.0",
    "simple-git": "^3.36.0",
-    "sitemap": "^7.1.2",
+    "sitemap": "^7.1.3",
+    "svg-path-commander": "^2.2.1",
    "svg-pathdata": "^6.0.3",
-    "svgson": "^5.3.1"
+    "svgson": "^5.3.1",
+    "vitepress": "^1.6.4",
+    "vitepress-plugin-group-icons": "^1.7.5",
+    "vitepress-plugin-llms": "^1.13.3"
  },
  "dependencies": {
-    "@floating-ui/vue": "^1.1.9",
+    "@floating-ui/vue": "^1.1.11",
    "@headlessui/vue": "^1.7.23",
    "@lucide/vue": "workspace:*",
-    "@vueuse/components": "^14.0.0",
-    "@vueuse/core": "^14.0.0",
+    "@vueuse/components": "^14.3.0",
+    "@vueuse/core": "^14.3.0",
+    "@vueuse/integrations": "^14.3.0",
    "element-to-path": "^1.2.1",
-    "fuse.js": "^7.1.0",
+    "fuse.js": "^7.5.0",
    "jszip": "^3.10.1",
    "lodash-es": "^4.18.1",
    "lucide": "workspace:*",
@@ -64,6 +68,6 @@
    "react": "18.2.0",
    "react-dom": "18.2.0",
    "sandpack-vue3": "3.1.12",
-    "vue": "^3.5.24"
+    "vue": "^3.5.40"
  }
 }
@@ -1,28 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="10 -10 304 120">
-  <g clip-path="url(#a)">
-    <g clip-path="url(#b)">
-      <path fill="url(#c)" d="M72 0H28A28 28 0 0 0 0 28v44a28 28 0 0 0 28 28h44a28 28 0 0 0 28-28V28A28 28 0 0 0 72 0Z"/>
-      <path stroke="#161616" stroke-linecap="round" stroke-linejoin="round" stroke-width="4" d="m47.81 54.34 26.63-6.66-19.73-19.1-26.63 6.67 19.73 19.1Z"/>
-      <path stroke="#161616" stroke-linecap="round" stroke-linejoin="round" stroke-width="4" d="m47.81 54.34 18.23-4.56c.67 5.86-.29 11.8-2.76 17.15a31.87 31.87 0 0 0-19.65 3.01 31.87 31.87 0 0 0-15.5-12.43 32.2 32.2 0 0 1 6.18-16.23l13.5 13.06Z"/>
-      <path stroke="#161616" stroke-linecap="round" stroke-linejoin="round" stroke-width="4" d="m33.37 67.04 5.17-19.32 11.84-2.96m-2.57 9.58 26.63-6.66-19.73-19.1-26.63 6.67 19.73 19.1Zm0 0 18.23-4.56c.67 5.86-.29 11.8-2.76 17.15a31.87 31.87 0 0 0-19.65 3.01 31.87 31.87 0 0 0-15.5-12.43 32.2 32.2 0 0 1 6.18-16.23l13.5 13.06Z"/>
-    </g>
-    <path fill="#161616" d="M281.5 67.51c-2.63 0-4.9-.54-6.8-1.64a11.08 11.08 0 0 1-4.39-4.67 15.64 15.64 0 0 1-1.53-7.14c0-2.7.51-5.05 1.53-7.09a11.6 11.6 0 0 1 4.33-4.77 12.14 12.14 0 0 1 6.53-1.72c1.62 0 3.14.26 4.57.78 1.44.51 2.72 1.3 3.82 2.39a11.18 11.18 0 0 1 2.62 4.12c.64 1.66.96 3.64.96 5.93v1.9h-21.46v-4.16h15.54a6.63 6.63 0 0 0-.76-3.16 5.58 5.58 0 0 0-2.1-2.2 5.9 5.9 0 0 0-3.1-.8c-1.26 0-2.37.31-3.33.92-.95.6-1.7 1.4-2.23 2.4a6.88 6.88 0 0 0-.8 3.21v3.63c0 1.53.28 2.83.83 3.92a5.96 5.96 0 0 0 2.34 2.5c1 .56 2.17.84 3.51.84.9 0 1.71-.12 2.44-.37a5.4 5.4 0 0 0 1.89-1.14c.53-.5.94-1.12 1.21-1.86l5.76.65a9 9 0 0 1-2.08 3.99c-1 1.12-2.3 2-3.88 2.62-1.58.61-3.39.92-5.42.92Z"/>
-    <path fill="#161616" d="M263.56 32.1V67h-6.17V32.1h6.17Z"/>
-    <path fill="#161616" d="M236.87 67.46a9.9 9.9 0 0 1-5.52-1.58 10.77 10.77 0 0 1-3.85-4.6 17.18 17.18 0 0 1-1.42-7.34c0-2.9.48-5.36 1.43-7.36a10.6 10.6 0 0 1 3.9-4.55 10.03 10.03 0 0 1 5.48-1.55c1.53 0 2.8.26 3.78.78a7.13 7.13 0 0 1 2.35 1.86c.58.72 1.03 1.4 1.35 2.03h.26V32.09h6.18V67h-6.06v-4.13h-.38c-.32.64-.78 1.32-1.38 2.03a7.6 7.6 0 0 1-6.12 2.56Zm1.72-5.06c1.3 0 2.42-.35 3.34-1.06a6.6 6.6 0 0 0 2.1-2.98c.48-1.27.72-2.76.72-4.45 0-1.7-.24-3.17-.72-4.42a6.28 6.28 0 0 0-2.08-2.91 5.38 5.38 0 0 0-3.36-1.04c-1.37 0-2.52.36-3.44 1.07a6.5 6.5 0 0 0-2.08 2.97c-.47 1.26-.7 2.7-.7 4.33 0 1.64.23 3.1.7 4.38a6.84 6.84 0 0 0 2.1 3.02 5.4 5.4 0 0 0 3.42 1.09Z"/>
-    <path fill="#161616" d="M209.37 67.51c-2.56 0-4.77-.56-6.65-1.69a11.46 11.46 0 0 1-4.36-4.72 15.52 15.52 0 0 1-1.53-7.09c0-2.7.5-5.07 1.53-7.1a11.43 11.43 0 0 1 4.36-4.75 12.68 12.68 0 0 1 6.65-1.68c2.56 0 4.78.56 6.65 1.68a11.32 11.32 0 0 1 4.35 4.74 15.47 15.47 0 0 1 1.55 7.11c0 2.7-.52 5.07-1.55 7.1a11.34 11.34 0 0 1-4.35 4.71 12.68 12.68 0 0 1-6.65 1.7Zm.04-4.94c1.38 0 2.54-.38 3.47-1.14a6.89 6.89 0 0 0 2.08-3.1c.47-1.3.7-2.74.7-4.34 0-1.6-.23-3.05-.7-4.34a6.88 6.88 0 0 0-2.08-3.12 5.27 5.27 0 0 0-3.47-1.16c-1.42 0-2.6.39-3.55 1.16a7 7 0 0 0-2.1 3.12c-.45 1.3-.68 2.74-.68 4.34 0 1.6.23 3.04.68 4.33a7 7 0 0 0 2.1 3.1 5.46 5.46 0 0 0 3.55 1.15Z"/>
-    <path fill="#161616" d="M180.17 67.51c-2.56 0-4.77-.56-6.65-1.69a11.46 11.46 0 0 1-4.36-4.72 15.52 15.52 0 0 1-1.54-7.09c0-2.7.51-5.07 1.54-7.1a11.43 11.43 0 0 1 4.36-4.75 12.68 12.68 0 0 1 6.65-1.68c2.56 0 4.77.56 6.65 1.68a11.32 11.32 0 0 1 4.34 4.74 15.49 15.49 0 0 1 1.55 7.11c0 2.7-.51 5.07-1.55 7.1a11.34 11.34 0 0 1-4.34 4.71 12.68 12.68 0 0 1-6.65 1.7Zm.03-4.94c1.39 0 2.55-.38 3.48-1.14a6.89 6.89 0 0 0 2.08-3.1c.47-1.3.7-2.74.7-4.34 0-1.6-.23-3.05-.7-4.34a6.88 6.88 0 0 0-2.08-3.12 5.26 5.26 0 0 0-3.48-1.16c-1.42 0-2.6.39-3.54 1.16a7 7 0 0 0-2.1 3.12c-.45 1.3-.68 2.74-.68 4.34 0 1.6.23 3.04.68 4.33a7 7 0 0 0 2.1 3.1 5.46 5.46 0 0 0 3.54 1.15Z"/>
-    <path fill="#161616" d="M162.13 32.1V67h-5.62l-16.45-23.78h-.3V67h-6.32V32.1h5.66l16.43 23.79h.31v-23.8h6.3Z"/>
-  </g>
-  <defs>
-    <clipPath id="a">
-      <path fill="#161616" d="M0 0h293.14v100H0z"/>
-    </clipPath>
-    <clipPath id="b">
-      <path fill="#161616" d="M0 0h100v100H0z"/>
-    </clipPath>
-    <linearGradient id="c" x1="0" x2="100" y1="50" y2="50" gradientUnits="userSpaceOnUse">
-      <stop stop-color="#F77062"/>
-      <stop offset="1" stop-color="#FE5196"/>
-    </linearGradient>
-  </defs>
-</svg>
@@ -1,28 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="10 -10 304 120">
-  <g clip-path="url(#a)">
-    <g clip-path="url(#b)">
-      <path fill="url(#c)" d="M72 0H28A28 28 0 0 0 0 28v44a28 28 0 0 0 28 28h44a28 28 0 0 0 28-28V28A28 28 0 0 0 72 0Z"/>
-      <path stroke="#161616" stroke-linecap="round" stroke-linejoin="round" stroke-width="4" d="m47.81 54.34 26.63-6.66-19.73-19.1-26.63 6.67 19.73 19.1Z"/>
-      <path stroke="#161616" stroke-linecap="round" stroke-linejoin="round" stroke-width="4" d="m47.81 54.34 18.23-4.56c.67 5.86-.29 11.8-2.76 17.15a31.87 31.87 0 0 0-19.65 3.01 31.87 31.87 0 0 0-15.5-12.43 32.2 32.2 0 0 1 6.18-16.23l13.5 13.06Z"/>
-      <path stroke="#161616" stroke-linecap="round" stroke-linejoin="round" stroke-width="4" d="m33.37 67.04 5.17-19.32 11.84-2.96m-2.57 9.58 26.63-6.66-19.73-19.1-26.63 6.67 19.73 19.1Zm0 0 18.23-4.56c.67 5.86-.29 11.8-2.76 17.15a31.87 31.87 0 0 0-19.65 3.01 31.87 31.87 0 0 0-15.5-12.43 32.2 32.2 0 0 1 6.18-16.23l13.5 13.06Z"/>
-    </g>
-    <path fill="#fff" d="M281.5 67.51c-2.63 0-4.9-.54-6.8-1.64a11.08 11.08 0 0 1-4.39-4.67 15.64 15.64 0 0 1-1.53-7.14c0-2.7.51-5.05 1.53-7.09a11.6 11.6 0 0 1 4.33-4.77 12.14 12.14 0 0 1 6.53-1.72c1.62 0 3.14.26 4.57.78 1.44.51 2.72 1.3 3.82 2.39a11.18 11.18 0 0 1 2.62 4.12c.64 1.66.96 3.64.96 5.93v1.9h-21.46v-4.16h15.54a6.63 6.63 0 0 0-.76-3.16 5.58 5.58 0 0 0-2.1-2.2 5.9 5.9 0 0 0-3.1-.8c-1.26 0-2.37.31-3.33.92-.95.6-1.7 1.4-2.23 2.4a6.88 6.88 0 0 0-.8 3.21v3.63c0 1.53.28 2.83.83 3.92a5.96 5.96 0 0 0 2.34 2.5c1 .56 2.17.84 3.51.84.9 0 1.71-.12 2.44-.37a5.4 5.4 0 0 0 1.89-1.14c.53-.5.94-1.12 1.21-1.86l5.76.65a9 9 0 0 1-2.08 3.99c-1 1.12-2.3 2-3.88 2.62-1.58.61-3.39.92-5.42.92Z"/>
-    <path fill="#fff" d="M263.56 32.1V67h-6.17V32.1h6.17Z"/>
-    <path fill="#fff" d="M236.87 67.46a9.9 9.9 0 0 1-5.52-1.58 10.77 10.77 0 0 1-3.85-4.6 17.18 17.18 0 0 1-1.42-7.34c0-2.9.48-5.36 1.43-7.36a10.6 10.6 0 0 1 3.9-4.55 10.03 10.03 0 0 1 5.48-1.55c1.53 0 2.8.26 3.78.78a7.13 7.13 0 0 1 2.35 1.86c.58.72 1.03 1.4 1.35 2.03h.26V32.09h6.18V67h-6.06v-4.13h-.38c-.32.64-.78 1.32-1.38 2.03a7.6 7.6 0 0 1-6.12 2.56Zm1.72-5.06c1.3 0 2.42-.35 3.34-1.06a6.6 6.6 0 0 0 2.1-2.98c.48-1.27.72-2.76.72-4.45 0-1.7-.24-3.17-.72-4.42a6.28 6.28 0 0 0-2.08-2.91 5.38 5.38 0 0 0-3.36-1.04c-1.37 0-2.52.36-3.44 1.07a6.5 6.5 0 0 0-2.08 2.97c-.47 1.26-.7 2.7-.7 4.33 0 1.64.23 3.1.7 4.38a6.84 6.84 0 0 0 2.1 3.02 5.4 5.4 0 0 0 3.42 1.09Z"/>
-    <path fill="#fff" d="M209.37 67.51c-2.56 0-4.77-.56-6.65-1.69a11.46 11.46 0 0 1-4.36-4.72 15.52 15.52 0 0 1-1.53-7.09c0-2.7.5-5.07 1.53-7.1a11.43 11.43 0 0 1 4.36-4.75 12.68 12.68 0 0 1 6.65-1.68c2.56 0 4.78.56 6.65 1.68a11.32 11.32 0 0 1 4.35 4.74 15.47 15.47 0 0 1 1.55 7.11c0 2.7-.52 5.07-1.55 7.1a11.34 11.34 0 0 1-4.35 4.71 12.68 12.68 0 0 1-6.65 1.7Zm.04-4.94c1.38 0 2.54-.38 3.47-1.14a6.89 6.89 0 0 0 2.08-3.1c.47-1.3.7-2.74.7-4.34 0-1.6-.23-3.05-.7-4.34a6.88 6.88 0 0 0-2.08-3.12 5.27 5.27 0 0 0-3.47-1.16c-1.42 0-2.6.39-3.55 1.16a7 7 0 0 0-2.1 3.12c-.45 1.3-.68 2.74-.68 4.34 0 1.6.23 3.04.68 4.33a7 7 0 0 0 2.1 3.1 5.46 5.46 0 0 0 3.55 1.15Z"/>
-    <path fill="#fff" d="M180.17 67.51c-2.56 0-4.77-.56-6.65-1.69a11.46 11.46 0 0 1-4.36-4.72 15.52 15.52 0 0 1-1.54-7.09c0-2.7.51-5.07 1.54-7.1a11.43 11.43 0 0 1 4.36-4.75 12.68 12.68 0 0 1 6.65-1.68c2.56 0 4.77.56 6.65 1.68a11.32 11.32 0 0 1 4.34 4.74 15.49 15.49 0 0 1 1.55 7.11c0 2.7-.51 5.07-1.55 7.1a11.34 11.34 0 0 1-4.34 4.71 12.68 12.68 0 0 1-6.65 1.7Zm.03-4.94c1.39 0 2.55-.38 3.48-1.14a6.89 6.89 0 0 0 2.08-3.1c.47-1.3.7-2.74.7-4.34 0-1.6-.23-3.05-.7-4.34a6.88 6.88 0 0 0-2.08-3.12 5.26 5.26 0 0 0-3.48-1.16c-1.42 0-2.6.39-3.54 1.16a7 7 0 0 0-2.1 3.12c-.45 1.3-.68 2.74-.68 4.34 0 1.6.23 3.04.68 4.33a7 7 0 0 0 2.1 3.1 5.46 5.46 0 0 0 3.54 1.15Z"/>
-    <path fill="#fff" d="M162.13 32.1V67h-5.62l-16.45-23.78h-.3V67h-6.32V32.1h5.66l16.43 23.79h.31v-23.8h6.3Z"/>
-  </g>
-  <defs>
-    <clipPath id="a">
-      <path fill="#fff" d="M0 0h293.14v100H0z"/>
-    </clipPath>
-    <clipPath id="b">
-      <path fill="#fff" d="M0 0h100v100H0z"/>
-    </clipPath>
-    <linearGradient id="c" x1="0" x2="100" y1="50" y2="50" gradientUnits="userSpaceOnUse">
-      <stop stop-color="#F77062"/>
-      <stop offset="1" stop-color="#FE5196"/>
-    </linearGradient>
-  </defs>
-</svg>
@@ -1,9 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 151 31">
-  <path fill="#111" d="M49.37 7.6c-8.39 0-10.49 1.8-11.13 5.39-.62 3.58.93 5.06 8.1 5.06 4.2 0 5.39 0 5.2 1.04-.2 1.06-1.4 1.06-4.4 1.06-3 0-4.19 0-3.96-1.2H36.9c-.74 4.2 1.13 5.4 9.53 5.4 8.39 0 10.68-1.2 11.42-5.4.65-3.58-1.2-5.1-8.39-5.1-4.2 0-5.39-.02-5.2-1.03.2-1.06 1.4-1.06 4.4-1.06 2.38 0 4.19 0 3.96 1.2h5.97c.65-3.69-.83-5.36-9.23-5.36Z"/>
-  <path fill="#FFC158" d="M.84 15.81C.84 4.45 4.63.66 16 .66c11.37 0 15.15 3.79 15.15 15.15S27.36 30.96 16 30.96C4.63 30.96.84 27.17.84 15.81Z"/>
-  <path fill="#fff" fill-rule="evenodd" d="m16.16 8.37-5.8 8.87c-.18.28.02.65.36.65h5.32l-.99 5.37c-.08.46.52.7.77.31l5.8-8.86a.42.42 0 0 0-.36-.66H15.94l1-5.37c.08-.46-.52-.7-.78-.31Z" clip-rule="evenodd"/>
-  <path fill="#111" d="m77.04 8.18-1.38 7.78c-.53 3-2.9 4.2-5.33 4.2s-4.37-1.2-3.82-4.2l1.39-7.78h-6.71l-1.42 7.78c-1.08 5.97 2.14 8.39 7.63 8.39 4.28 0 7.04-1.81 7.04-1.81l.4 1.2h6.08l2.8-15.56h-6.68Z"/>
-  <path fill="#111" d="M98.83 7.6c-4.27 0-6.41 1.8-6.41 1.8l.23-1.19h-6.7l-4.09 22.75h6.71l1.51-8.39s1.52 1.8 5.8 1.8c5.48 0 10.05-1.8 11.24-8.38 1.15-6.62-2.8-8.4-8.29-8.4Zm1.55 8.36c-.53 3-2.9 4.2-5.33 4.2s-4.37-1.2-3.82-4.2c.53-3 2.9-4.2 5.33-4.2s4.34 1.2 3.82 4.2Z"/>
-  <path fill="#111" d="M121.08 7.6c-7.3 0-11.67 2.26-12.76 8.23-1.08 5.97 2.47 8.52 9.77 8.52 5.13 0 7.92-.9 10.55-3.23l-3.91-2.49c-.86.52-1.78 1.52-5.89 1.52-2.76 0-4-1.03-3.94-3.13h15.72c.1-.39.2-.77.26-1.2 1.05-6-2.5-8.22-9.8-8.22Zm-5.52 6.42c.78-1.68 2-2.26 4.76-2.26 2.73 0 3.78.55 3.95 2.26h-8.71Z"/>
-  <path fill="#111" d="m140.33 9.37.23-1.2h-6.7l-2.8 15.56h6.7l1.19-6.58c.76-4.2 3.91-4.78 6.35-4.78 2.4 0 3.19.26 4.76.62l.86-4.78c-.86-.26-2.9-.61-4.77-.61-4.27 0-5.82 1.77-5.82 1.77Z"/>
-</svg>
@@ -1,9 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 151 31">
-  <path fill="#fff" d="M49.37 7.6c-8.39 0-10.49 1.8-11.13 5.39-.62 3.58.93 5.06 8.1 5.06 4.2 0 5.39 0 5.2 1.04-.2 1.06-1.4 1.06-4.4 1.06-3 0-4.19 0-3.96-1.2H36.9c-.74 4.2 1.13 5.4 9.53 5.4 8.39 0 10.68-1.2 11.42-5.4.65-3.58-1.2-5.1-8.39-5.1-4.2 0-5.39-.02-5.2-1.03.2-1.06 1.4-1.06 4.4-1.06 2.38 0 4.19 0 3.96 1.2h5.97c.65-3.69-.83-5.36-9.23-5.36Z"/>
-  <path fill="#FFC158" d="M.84 15.81C.84 4.45 4.63.66 16 .66c11.37 0 15.15 3.79 15.15 15.15S27.36 30.96 16 30.96C4.63 30.96.84 27.17.84 15.81Z"/>
-  <path fill="#fff" fill-rule="evenodd" d="m16.16 8.37-5.8 8.87c-.18.28.02.65.36.65h5.32l-.99 5.37c-.08.46.52.7.77.31l5.8-8.86a.42.42 0 0 0-.36-.66H15.94l1-5.37c.08-.46-.52-.7-.78-.31Z" clip-rule="evenodd"/>
-  <path fill="#fff" d="m77.04 8.18-1.38 7.78c-.53 3-2.9 4.2-5.33 4.2s-4.37-1.2-3.82-4.2l1.39-7.78h-6.71l-1.42 7.78c-1.08 5.97 2.14 8.39 7.63 8.39 4.28 0 7.04-1.81 7.04-1.81l.4 1.2h6.08l2.8-15.56h-6.68Z"/>
-  <path fill="#fff" d="M98.83 7.6c-4.27 0-6.41 1.8-6.41 1.8l.23-1.19h-6.7l-4.09 22.75h6.71l1.51-8.39s1.52 1.8 5.8 1.8c5.48 0 10.05-1.8 11.24-8.38 1.15-6.62-2.8-8.4-8.29-8.4Zm1.55 8.36c-.53 3-2.9 4.2-5.33 4.2s-4.37-1.2-3.82-4.2c.53-3 2.9-4.2 5.33-4.2s4.34 1.2 3.82 4.2Z"/>
-  <path fill="#fff" d="M121.08 7.6c-7.3 0-11.67 2.26-12.76 8.23-1.08 5.97 2.47 8.52 9.77 8.52 5.13 0 7.92-.9 10.55-3.23l-3.91-2.49c-.86.52-1.78 1.52-5.89 1.52-2.76 0-4-1.03-3.94-3.13h15.72c.1-.39.2-.77.26-1.2 1.05-6-2.5-8.22-9.8-8.22Zm-5.52 6.42c.78-1.68 2-2.26 4.76-2.26 2.73 0 3.78.55 3.95 2.26h-8.71Z"/>
-  <path fill="#fff" d="m140.33 9.37.23-1.2h-6.7l-2.8 15.56h6.7l1.19-6.58c.76-4.2 3.91-4.78 6.35-4.78 2.4 0 3.19.26 4.76.62l.86-4.78c-.86-.26-2.9-.61-4.77-.61-4.27 0-5.82 1.77-5.82 1.77Z"/>
-</svg>
@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 160 200" fill="none">
+  <path fill="#00e8ff" d="M40 120l20-60l90 90l-30 50l-40-40h-20" />
+  <path fill="#283198" d="M80 160 L80 80 L120 40 L 120 120 M0 160 L40 200 L40 120 L20 120" />
+  <path fill="#324fff" d="M40 120v-80l40-40v80M120 200v-80l40-40v80M0 160v-80l40 40" />
+  <path fill="#0ff" d="M40 200v-80l40 40" />
+</svg>
@@ -23,11 +23,12 @@ const writeIconFiles = icons.map(async (iconFileName) => {
  const location = path.resolve(iconDetailsDirectory, `${iconName}.ts`);

  const contents = `\
-import iconNode from '../iconNodes/${iconName}.node.json'
-import metaData from '../../../../icons/${iconName}.json'
-import releaseData from '../releaseMetadata/${iconName}.json'
+import iconNode from '../iconNodes/${iconName}.node.json' with { type: 'json' };
+import metaData from '../../../../icons/${iconName}.json' with { type: 'json' };
+import releaseData from '../releaseMetadata/${iconName}.json' with { type: 'json' };
+import popularity from '../iconPopularity/${iconName}.json' with { type: 'json' };

-const { tags, categories, contributors, aliases, deprecated, deprecationReason, toBeRemovedInVersion } = metaData
+const { tags, categories, contributors, aliases, deprecated, deprecationReason, toBeRemovedInVersion } = metaData;

 const iconDetails = {
  name: '${iconName}',
@@ -37,12 +38,13 @@ const iconDetails = {
  categories,
  aliases,
  deprecated,
+  popularity,
  deprecationReason,
  toBeRemovedInVersion,
  ...releaseData,
-}
+};

-export default iconDetails
+export default iconDetails;
  `;

  await fs.promises.writeFile(location, contents, 'utf-8');
@@ -42,7 +42,7 @@ const getRelatedIcons = (currentIcon, icons) => {
 };

 const iconsMetaDataPromises = svgFiles.map(async (iconName) => {
-  const metaDataFileContent = await fs.promises.readFile(`../icons/${iconName}`);
+  const metaDataFileContent = await fs.promises.readFile(`../icons/${iconName}`, 'utf-8');
  const metaData = JSON.parse(metaDataFileContent);

  const name = iconName.replace('.json', '');
@@ -0,0 +1,49 @@
+import fs from 'fs';
+import path from 'path';
+import { readSvgDirectory, toCamelCase } from '@lucide/helpers';
+
+const currentDir = process.cwd();
+const ICONS_DIR = path.resolve(currentDir, '../lab');
+const iconJsonFiles = await readSvgDirectory(ICONS_DIR, '.json');
+
+const labDirectory = path.resolve(currentDir, '.vitepress/data/lab');
+const location = path.resolve(currentDir, labDirectory, 'iconMetaData.ts');
+
+if (fs.existsSync(location)) {
+  fs.unlinkSync(location);
+}
+
+if (!fs.existsSync(labDirectory)) {
+  fs.mkdirSync(labDirectory);
+}
+
+const iconMetaIndexFileImports = [];
+const iconMetaIndexFileExports = [];
+
+iconJsonFiles.forEach((iconJsonFile) => {
+  const iconName = path.basename(iconJsonFile, '.json');
+
+  iconMetaIndexFileImports.push(
+    `import ${toCamelCase(iconName)}Metadata from '../../../../lab/${iconName}.json';`,
+  );
+  iconMetaIndexFileExports.push(`  '${iconName}': ${toCamelCase(iconName)}Metadata,`);
+});
+
+try {
+  await fs.promises.writeFile(
+    location,
+    `\
+${iconMetaIndexFileImports.join('\n')}
+
+
+  export default {
+${iconMetaIndexFileExports.join('\n')}
+  }
+    `,
+    'utf-8',
+  );
+
+  console.log('Successfully write icon json file index');
+} catch (error) {
+  throw new Error(`Something went wrong generating icon json file index file,\n ${error}`);
+}
@@ -0,0 +1,62 @@
+import fs from 'fs';
+import path from 'path';
+import { renderIconsObject } from '@lucide/build-icons';
+import { readSvgDirectory, toCamelCase } from '@lucide/helpers';
+
+const currentDir = process.cwd();
+const ICONS_DIR = path.resolve(currentDir, '../lab');
+const svgFiles = await readSvgDirectory(ICONS_DIR);
+const icons = await renderIconsObject(svgFiles, ICONS_DIR, true);
+
+const iconNodesDirectory = path.resolve(currentDir, '.vitepress/data/lab', 'iconNodes');
+
+if (fs.existsSync(iconNodesDirectory)) {
+  fs.rmSync(iconNodesDirectory, { recursive: true, force: true });
+}
+
+if (!fs.existsSync(iconNodesDirectory)) {
+  fs.mkdirSync(iconNodesDirectory);
+}
+
+const iconIndexFile = path.resolve(iconNodesDirectory, `index.ts`);
+const iconIndexFileImports: string[] = [];
+const iconIndexFileExports: string[] = [];
+const iconIndexFileDefaultExports: string[] = [];
+
+const writeIconFiles = Object.entries(icons).map(async ([iconName, { children }]) => {
+  // We need to use .node.json because the there is a file called package, which is a reserved word for packages.
+  const location = path.resolve(iconNodesDirectory, `${iconName}.node.json`);
+  const iconNode = children.map(({ name, attributes }) => [name, attributes]);
+
+  const output = JSON.stringify(iconNode, null, 2);
+  await fs.promises.writeFile(location, output, 'utf-8');
+
+  iconIndexFileImports.push(
+    `import ${toCamelCase(iconName)}Node from './${iconName}.node.json' with { type: "json" };`,
+  );
+  iconIndexFileExports.push(`  ${toCamelCase(iconName)}Node as ${toCamelCase(iconName)},`);
+  iconIndexFileDefaultExports.push(`  '${iconName}': ${toCamelCase(iconName)}Node,`);
+});
+
+try {
+  await Promise.all(writeIconFiles);
+  await fs.promises.writeFile(
+    iconIndexFile,
+    `\
+${iconIndexFileImports.join('\n')}
+
+export {
+${iconIndexFileExports.join('\n')}
+}
+
+export default {
+${iconIndexFileDefaultExports.join('\n')}
+}
+  `,
+    'utf-8',
+  );
+
+  console.log('Successfully write', writeIconFiles.length, 'iconNodes.');
+} catch (error) {
+  throw new Error(`Something went wrong generating iconNode files,\n ${error}`);
+}
@@ -70,10 +70,10 @@ const comparisonsPromises = tags.map(async (tag, index) => {
  };
 });

-const comparisons = await Promise.all(comparisonsPromises);
+const comparisons = (await Promise.all(comparisonsPromises)).filter((comparison) => comparison != null && Object.keys(comparison.iconFiles).length > 0);
 const newReleaseMetaData = {};

-comparisons.forEach(({ tag, iconFiles, date } = {}) => {
+comparisons.forEach(({ tag, iconFiles, date }) => {
  if (tag == null) return;

  iconFiles.forEach(({ status, file, renamedFile }) => {
@@ -11,7 +11,7 @@ const iconMetaData = await getIconMetaData(path.resolve(scriptDir, '../../icons'
 const iconAliasesRedirectRoutes = Object.entries(iconMetaData)
  .filter(([, { aliases }]) => aliases?.length)
  .map(([iconName, { aliases }]) => {
-    const aliasRouteMatches = aliases.map((alias) => alias.name).join('|');
+    const aliasRouteMatches = aliases.map((alias) => typeof alias === 'string' ? alias : alias?.name).join('|');

    return {
      src: `^/icons/(${aliasRouteMatches})$`,
@@ -0,0 +1,152 @@
+/* eslint-disable no-restricted-syntax,  no-await-in-loop */
+import fs from 'fs';
+import path from 'path';
+import { loadEnvFile } from 'node:process';
+import { readSvgDirectory } from '@lucide/helpers';
+
+const currentDir = process.cwd();
+const dataDirectory = path.resolve(currentDir, '.vitepress/data');
+
+try {
+  // Load environment variables from .env file, if it exists.
+  loadEnvFile(`${currentDir}/.env`);
+} catch (error) {}
+
+interface IconCollection {
+  /** Human readable name, used for logging. */
+  name: string;
+  /** Directory containing the icon `.json` files. */
+  iconsDir: string;
+  /** Directory the `${iconName}.json` popularity files are written to. */
+  outputDir: string;
+  /** Matches an analytics route and captures the icon name in group 1. */
+  routePattern: RegExp;
+}
+
+// Lab must come before the default collection because `/icons/lab/foo` also
+// matches the default `/icons/(...)` pattern; the first match wins per route.
+const iconCollections: IconCollection[] = [
+  {
+    name: 'lab',
+    iconsDir: path.resolve(currentDir, '../lab'),
+    outputDir: path.resolve(dataDirectory, 'lab', 'iconPopularity'),
+    // e.g. /icons/lab/burger, /icons/lab/burger/ or /icons/lab/burger?ref=homepage
+    routePattern: /^\/icons\/lab\/([^\/\?]+)(?:[\/\?]|$)/,
+  },
+  {
+    name: 'default',
+    iconsDir: path.resolve(currentDir, '../icons'),
+    outputDir: path.resolve(dataDirectory, 'iconPopularity'),
+    // e.g. /icons/activity, /icons/activity/ or /icons/activity?ref=homepage
+    routePattern: /^\/icons\/([^\/\?]+)(?:[\/\?]|$)/,
+  },
+];
+
+interface CollectionData extends IconCollection {
+  iconNames: string[];
+  counts: Record<string, number>;
+}
+
+const collections: CollectionData[] = await Promise.all(
+  iconCollections.map(async (collection) => {
+    const iconJsonFiles = await readSvgDirectory(collection.iconsDir, '.json');
+    const iconNames = iconJsonFiles.map((file) => path.basename(file, '.json'));
+
+    return {
+      ...collection,
+      iconNames,
+      counts: Object.fromEntries(iconNames.map((iconName) => [iconName, 0])),
+    };
+  }),
+);
+
+interface AnalyticsResponse {
+  results: {
+    dimensions: [route: string];
+    metrics: [count: number];
+  }[];
+}
+
+const writeIconPopularity = async ({ name, outputDir, counts }: CollectionData) => {
+  if (fs.existsSync(outputDir)) {
+    fs.rmSync(outputDir, { recursive: true, force: true });
+  }
+  fs.mkdirSync(outputDir, { recursive: true });
+
+  const writePopularityPromises = Object.entries(counts).map(([iconName, count]) => {
+    const location = path.resolve(outputDir, `${iconName}.json`);
+    return fs.promises.writeFile(location, JSON.stringify({ count }, null, 2), 'utf-8');
+  });
+
+  await Promise.all(writePopularityPromises);
+  console.log(
+    'Successfully written icon popularity data for',
+    writePopularityPromises.length,
+    `${name} icons.`,
+  );
+};
+
+const writeAllIconPopularity = () => Promise.all(collections.map(writeIconPopularity));
+
+if (process.env.LUCIDE_ANALYTICS_TOKEN === undefined) {
+  console.warn('LUCIDE_ANALYTICS_TOKEN environment variable is not set. Writing default icon popularity data.');
+  await writeAllIconPopularity();
+  process.exit(0);
+}
+
+try {
+  const response = await fetch('https://analytics.lucide.dev/api/v2/query', {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      Authorization: `Bearer ${process.env.LUCIDE_ANALYTICS_TOKEN}`,
+    },
+    body: JSON.stringify({
+      "site_id": "lucide.dev",
+      "metrics": [
+          "visitors"
+      ],
+      "dimensions": [
+          "visit:entry_page"
+      ],
+      "date_range": "12mo"
+    }),
+  })
+
+  if (!response.ok) {
+    throw new Error(`Network response was not ok: ${response.statusText}`);
+  }
+
+  const analyticsData: AnalyticsResponse = await response.json();
+
+  for (const { dimensions, metrics } of analyticsData.results) {
+    const [route] = dimensions;
+    const [count] = metrics;
+
+    if (!route.startsWith('/icons')) {
+      continue;
+    }
+
+    // Route each visit to the first collection whose pattern matches. Lab is
+    // checked first so `/icons/lab/foo` is not swallowed by the default pattern.
+    for (const collection of collections) {
+      const match = route.match(collection.routePattern);
+      if (!match) {
+        continue;
+      }
+
+      const iconName = match[1];
+      if (collection.iconNames.includes(iconName)) {
+        collection.counts[iconName] += count;
+      }
+
+      break;
+    }
+  }
+
+  await writeAllIconPopularity();
+
+} catch (error) {
+  console.error('Error fetching analytics data:', error);
+  await writeAllIconPopularity();
+}
@@ -0,0 +1,49 @@
+import fs from 'fs';
+import path from 'path';
+import { readSvgDirectory, toCamelCase } from '@lucide/helpers';
+
+const currentDir = process.cwd();
+const ICONS_DIR = path.resolve(currentDir, '../lab');
+const iconJsonFiles = await readSvgDirectory(ICONS_DIR, '.json');
+
+const labIconPopularityDirectory = path.resolve(currentDir, '.vitepress/data/lab/iconPopularity');
+const location = path.resolve(currentDir, labIconPopularityDirectory, 'index.ts');
+
+if (fs.existsSync(location)) {
+  fs.unlinkSync(location);
+}
+
+if (!fs.existsSync(labIconPopularityDirectory)) {
+  fs.mkdirSync(labIconPopularityDirectory);
+}
+
+const iconMetaIndexFileImports = [];
+const iconMetaIndexFileExports = [];
+
+iconJsonFiles.forEach((iconJsonFile) => {
+  const iconName = path.basename(iconJsonFile, '.json');
+
+  iconMetaIndexFileImports.push(
+    `import ${toCamelCase(iconName)}Popularity from './${iconName}.json' with { type: 'json' };`,
+  );
+  iconMetaIndexFileExports.push(`  '${iconName}': ${toCamelCase(iconName)}Popularity,`);
+});
+
+try {
+  await fs.promises.writeFile(
+    location,
+    `\
+${iconMetaIndexFileImports.join('\n')}
+
+
+  export default {
+${iconMetaIndexFileExports.join('\n')}
+  }
+    `,
+    'utf-8',
+  );
+
+  console.log('Successfully write icon json file index');
+} catch (error) {
+  throw new Error(`Something went wrong generating icon json file index file,\n ${error}`);
+}
@@ -40,7 +40,7 @@
          }
        },
        "dependentRequired": {
-          "deprecated": ["deprecationReason", "toBeRemovedInVersion"],
+          "deprecated": ["deprecationReason"],
          "deprecationReason": ["deprecated"],
          "toBeRemovedInVersion": ["deprecated"]
        }
@@ -134,7 +134,7 @@
    }
  },
  "dependentRequired": {
-    "deprecated": ["deprecationReason", "toBeRemovedInVersion"],
+    "deprecated": ["deprecationReason"],
    "deprecationReason": ["deprecated"],
    "toBeRemovedInVersion": ["deprecated"]
  },
@@ -13,4 +13,4 @@
  <path d="M15.697 14h5.606" />
  <path d="m2 16 4.039-9.69a.5.5 0 0 1 .923 0L11 16" />
  <path d="M3.304 13h6.392" />
-</svg>
+</svg>
@@ -0,0 +1,35 @@
+{
+  "$schema": "../icon.schema.json",
+  "contributors": [
+    "ahtohbi4",
+    "jamiemlaw",
+    "karsa-mistmere",
+    "jguddas"
+  ],
+  "use-cases": [
+    "marking content as sponsored",
+    "linking to an advertise with us page"
+  ],
+  "tags": [
+    "advert",
+    "affiliate",
+    "brand",
+    "campaign",
+    "commercial",
+    "marketing",
+    "monetize",
+    "paid",
+    "partner",
+    "promo",
+    "sponsor",
+    "audio description",
+    "video description",
+    "described video",
+    "visual description"
+  ],
+  "categories": [
+    "multimedia",
+    "accessibility",
+    "notifications"
+  ]
+}
@@ -0,0 +1,16 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M10 13H6" />
+  <path d="M10 15v-4a2 2 0 0 0-4 0v4" />
+  <path d="M14 14.5a.5.5 0 0 0 .5.5h1a2.5 2.5 0 0 0 2.5-2.5v-1A2.5 2.5 0 0 0 15.5 9h-1a.5.5 0 0 0-.5.5z" />
+  <rect x="2" y="5" width="20" height="14" rx="2" />
+</svg>
@@ -23,8 +23,7 @@
    {
      "name": "alarm-check",
      "deprecationReason": "alias.name",
-      "deprecated": true,
-      "toBeRemovedInVersion": "v1.0"
+      "deprecated": true
    }
  ]
 }
@@ -19,8 +19,7 @@
    {
      "name": "alarm-minus",
      "deprecationReason": "alias.name",
-      "deprecated": true,
-      "toBeRemovedInVersion": "v1.0"
+      "deprecated": true
    }
  ]
 }
@@ -19,8 +19,7 @@
    {
      "name": "alarm-plus",
      "deprecationReason": "alias.name",
-      "deprecated": true,
-      "toBeRemovedInVersion": "v1.0"
+      "deprecated": true
    }
  ]
 }
@@ -11,10 +11,9 @@
 >
  <path d="M10 10H6" />
  <path d="M14 18V6a2 2 0 0 0-2-2H4a2 2 0 0 0-2 2v11a1 1 0 0 0 1 1h2" />
-  <path
-    d="M19 18h2a1 1 0 0 0 1-1v-3.28a1 1 0 0 0-.684-.948l-1.923-.641a1 1 0 0 1-.578-.502l-1.539-3.076A1 1 0 0 0 16.382 8H14" />
+  <path d="M19 18h2a1 1 0 0 0 1-1v-3.28a1 1 0 0 0-.684-.948l-1.923-.641a1 1 0 0 1-.578-.502l-1.539-3.076A1 1 0 0 0 16.382 8H14" />
  <path d="M8 8v4" />
  <path d="M9 18h6" />
  <circle cx="17" cy="18" r="2" />
  <circle cx="7" cy="18" r="2" />
-</svg>
+</svg>
--- a/Show More
+++ b/Show More