Merge branch 'main' of https://github.com/lucide-icons/lucide into adding-use-cases

* Added icons/scan-box.svg

* Added icons/scan-box.json

* Update scan-box.json

* Update scan-box.svg

* Update icons/scan-box.json

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* Update icons/scan-box.json

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

---------

Co-authored-by: Eric Fennis <eric.fennis@gmail.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

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

@@ -33,7 +33,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})
 

docs/.vitepress/config.ts

@@ -101,6 +101,7 @@ export default defineConfig({
       },
       { text: 'Packages', link: '/packages' },
       { text: 'Showcase', link: '/showcase' },
+      { text: 'Merch', link: 'https://merch.lucide.dev/' },
     ],
     sidebar,
     socialLinks: [

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

@@ -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"
   }
 ]

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

@@ -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',
+      },
     ],
   },
   {

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

@@ -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"
         />

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

@@ -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}`"
+      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);

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

@@ -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'));
 
@@ -178,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 = ''"

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

@@ -52,8 +52,12 @@ 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);
@@ -110,6 +114,9 @@ const searchResults = useSearch(searchQueryDebounced, mappedIcons, [
 ]);
 
 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);
@@ -135,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'));
@@ -179,7 +192,7 @@ function handleCloseDrawer() {
         ref="searchInput"
         :shortcut="kbdSearchShortcut"
         class="input-wrapper"
-        @focus="onFocusSearchInput"
+        @focus="loadSearchMetadata"
       />
 
       <Select
@@ -197,7 +210,7 @@ function handleCloseDrawer() {
       </Select>
     </StickyBar>
     <NoResults
-      v-if="searchPlaceholder.isNoResults"
+      v-if="searchPlaceholder.isNoResults && !isSearchMetadataLoading"
       :searchQuery="searchPlaceholder.query"
       :isBrandSearch="searchPlaceholder.isBrand"
       @clear="searchQuery = ''"

docs/guide/react-native/advanced/optimizations.md

@@ -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.
+:::

docs/package.json

@@ -32,31 +32,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.2.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:*",
@@ -65,6 +66,6 @@
     "react": "18.2.0",
     "react-dom": "18.2.0",
     "sandpack-vue3": "3.1.12",
-    "vue": "^3.5.24"
+    "vue": "^3.5.39"
   }
 }

docs/public/framework-logos/lit.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>

icon.schema.json

@@ -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"]
   },

icons/a-arrow-down.json

@@ -6,7 +6,9 @@
     "danielbayley",
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Decreasing the font size in a text editor"
+  ],
   "tags": [
     "letter",
     "font size",

icons/a-arrow-up.json

@@ -6,7 +6,9 @@
     "danielbayley",
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Increasing the font size in a text editor"
+  ],
   "tags": [
     "letter",
     "font size",

icons/accessibility.json

@@ -4,7 +4,10 @@
     "karsa-mistmere",
     "jguddas"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Representing physical disability or accessibility assistance",
+    "Marking wheelchair-accessible facilities or routes"
+  ],
   "tags": [
     "disability",
     "disabled",

icons/activity.json

@@ -4,7 +4,11 @@
     "colebemis",
     "jguddas"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Representing an activity feed or recent actions",
+    "Showing health metrics such as heart rate or vital signs",
+    "Indicating live system activity or monitoring"
+  ],
   "tags": [
     "pulse",
     "action",

icons/air-vent.json

@@ -4,7 +4,10 @@
     "karsa-mistmere",
     "jguddas"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Representing air conditioning or ventilation in smart home apps",
+    "Indicating climate control amenities on hotel and booking platforms"
+  ],
   "tags": [
     "air conditioner",
     "ac",

icons/airplay.json

@@ -5,7 +5,10 @@
     "csandman",
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Streaming or mirroring a screen to an external display",
+    "Casting media to a TV or compatible device"
+  ],
   "tags": [
     "stream",
     "cast",

icons/alarm-clock-check.json

@@ -6,7 +6,10 @@
     "jguddas",
     "karsa-mistmere"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Confirming an alarm or scheduled reminder is set",
+    "Marking a timed task as complete"
+  ],
   "tags": [
     "done",
     "todo",
@@ -23,8 +26,7 @@
     {
       "name": "alarm-check",
       "deprecationReason": "alias.name",
-      "deprecated": true,
-      "toBeRemovedInVersion": "v1.0"
+      "deprecated": true
     }
   ]
 }

icons/alarm-clock-minus.json

@@ -6,7 +6,9 @@
     "jguddas",
     "karsa-mistmere"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Removing or deleting an alarm"
+  ],
   "tags": [
     "remove"
   ],
@@ -19,8 +21,7 @@
     {
       "name": "alarm-minus",
       "deprecationReason": "alias.name",
-      "deprecated": true,
-      "toBeRemovedInVersion": "v1.0"
+      "deprecated": true
     }
   ]
 }

icons/alarm-clock-off.json

@@ -6,7 +6,9 @@
     "karsa-mistmere",
     "jguddas"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Turning off or disabling an alarm"
+  ],
   "tags": [
     "morning",
     "turn-off"

icons/alarm-clock-plus.json

@@ -6,7 +6,9 @@
     "jguddas",
     "karsa-mistmere"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Adding or creating a new alarm"
+  ],
   "tags": [
     "add"
   ],
@@ -19,8 +21,7 @@
     {
       "name": "alarm-plus",
       "deprecationReason": "alias.name",
-      "deprecated": true,
-      "toBeRemovedInVersion": "v1.0"
+      "deprecated": true
     }
   ]
 }

icons/alarm-clock.json

@@ -7,7 +7,9 @@
     "jguddas",
     "karsa-mistmere"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Setting an alarm or wake-up reminder"
+  ],
   "tags": [
     "morning"
   ],

icons/alarm-smoke.json

@@ -5,7 +5,10 @@
     "karsa-mistmere",
     "jguddas"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Representing a smoke or fire detector in smart home apps",
+    "Indicating fire safety equipment or amenities in listings"
+  ],
   "tags": [
     "fire",
     "alert",

icons/album.json

@@ -5,7 +5,10 @@
     "csandman",
     "mittalyashu"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Representing a photo album or collection",
+    "Indicating a music album"
+  ],
   "tags": [
     "photo",
     "book"

icons/align-center-horizontal.json

@@ -3,7 +3,9 @@
   "contributors": [
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Aligning elements to the horizontal center in page builders and design tools"
+  ],
   "tags": [
     "items",
     "flex",

icons/align-center-vertical.json

@@ -3,7 +3,9 @@
   "contributors": [
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Aligning elements to the vertical center in page builders and design tools"
+  ],
   "tags": [
     "items",
     "flex",

icons/align-end-horizontal.json

@@ -3,7 +3,9 @@
   "contributors": [
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Aligning elements to the horizontal end in page builders and design tools"
+  ],
   "tags": [
     "items",
     "bottom",

icons/align-end-vertical.json

@@ -3,7 +3,9 @@
   "contributors": [
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Aligning elements to the vertical end in page builders and design tools"
+  ],
   "tags": [
     "items",
     "right",

icons/align-horizontal-distribute-center.json

@@ -4,7 +4,9 @@
     "r4lv",
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Distributing elements evenly around their horizontal centers in design tools"
+  ],
   "tags": [
     "items",
     "flex",

icons/align-horizontal-distribute-end.json

@@ -4,7 +4,9 @@
     "r4lv",
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Distributing elements by their right edges in design tools"
+  ],
   "tags": [
     "right",
     "items",

icons/align-horizontal-distribute-start.json

@@ -4,7 +4,9 @@
     "r4lv",
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Distributing elements by their left edges in design tools"
+  ],
   "tags": [
     "left",
     "items",

icons/align-horizontal-justify-center.json

@@ -3,7 +3,9 @@
   "contributors": [
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Justifying elements around the horizontal center in design tools"
+  ],
   "tags": [
     "center",
     "items",

icons/align-horizontal-justify-end.json

@@ -3,7 +3,9 @@
   "contributors": [
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Justifying elements to the horizontal end in design tools"
+  ],
   "tags": [
     "right",
     "items",

icons/align-horizontal-justify-start.json

@@ -3,7 +3,9 @@
   "contributors": [
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Justifying elements to the horizontal start in design tools"
+  ],
   "tags": [
     "left",
     "items",

icons/align-horizontal-space-around.json

@@ -3,7 +3,9 @@
   "contributors": [
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Distributing elements with equal horizontal space around them in design tools"
+  ],
   "tags": [
     "center",
     "items",

icons/align-horizontal-space-between.json

@@ -3,7 +3,9 @@
   "contributors": [
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Distributing elements with equal horizontal space between them in design tools"
+  ],
   "tags": [
     "around",
     "items",

icons/align-start-horizontal.json

@@ -3,7 +3,9 @@
   "contributors": [
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Aligning elements to the horizontal start in page builders and design tools"
+  ],
   "tags": [
     "top",
     "items",

icons/align-start-vertical.json

@@ -3,7 +3,9 @@
   "contributors": [
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Aligning elements to the vertical start in page builders and design tools"
+  ],
   "tags": [
     "left",
     "items",

icons/align-vertical-distribute-center.json

@@ -4,7 +4,9 @@
     "ericfennis",
     "jguddas"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Distributing elements evenly around the vertical center in design tools"
+  ],
   "tags": [
     "items",
     "flex",

icons/align-vertical-distribute-end.json

@@ -3,7 +3,9 @@
   "contributors": [
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Distributing elements toward the vertical end in design tools"
+  ],
   "tags": [
     "bottom",
     "items",

icons/align-vertical-distribute-start.json

@@ -3,7 +3,9 @@
   "contributors": [
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Distributing elements toward the vertical start in design tools"
+  ],
   "tags": [
     "top",
     "items",

icons/align-vertical-justify-center.json

@@ -3,7 +3,9 @@
   "contributors": [
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Justifying elements around the vertical center in design tools"
+  ],
   "tags": [
     "center",
     "items",

icons/align-vertical-justify-end.json

@@ -3,7 +3,9 @@
   "contributors": [
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Justifying elements to the vertical end in design tools"
+  ],
   "tags": [
     "bottom",
     "items",

icons/align-vertical-justify-start.json

@@ -3,7 +3,9 @@
   "contributors": [
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Justifying elements to the vertical start in design tools"
+  ],
   "tags": [
     "top",
     "items",

icons/align-vertical-space-around.json

@@ -3,7 +3,9 @@
   "contributors": [
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Distributing elements with equal vertical space around them in design tools"
+  ],
   "tags": [
     "center",
     "items",

icons/align-vertical-space-between.json

@@ -3,7 +3,9 @@
   "contributors": [
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Distributing elements with equal vertical space between them in design tools"
+  ],
   "tags": [
     "center",
     "items",

icons/ambulance.json

@@ -11,7 +11,10 @@
     "karsa-mistmere",
     "danielbayley"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Directing users to nearby emergency services in navigation apps",
+    "Marking emergency contacts or medical transport services"
+  ],
   "tags": [
     "ambulance",
     "emergency",

icons/ampersand.json

@@ -5,7 +5,10 @@
     "karsa-mistmere",
     "jguddas"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Inserting an ampersand in text editors",
+    "Representing a join or concatenation operator in code"
+  ],
   "tags": [
     "and",
     "typography",

icons/ampersands.json

@@ -4,7 +4,9 @@
     "danielbayley",
     "karsa-mistmere"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Representing a logical AND operator in code"
+  ],
   "tags": [
     "and",
     "operator",

icons/amphora.json

@@ -3,7 +3,12 @@
   "contributors": [
     "karsa-mistmere"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Representing museological or archaeological artefacts",
+    "Indicating pottery or ceramics",
+    "Symbolizing Greek culture or antiquity",
+    "Denoting amphora-aged wines"
+  ],
   "tags": [
     "pottery",
     "artifact",

icons/anchor.json

@@ -6,7 +6,10 @@
     "ericfennis",
     "karsa-mistmere"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Representing a ship's anchor or maritime context",
+    "Linking to an anchor point or section within a page"
+  ],
   "tags": [
     "ship"
   ],

icons/angry.json

@@ -4,7 +4,10 @@
     "karsa-mistmere",
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Expressing strong dissatisfaction in feedback or rating scales",
+    "Marking the lowest score on a contentment scale (very unhappy to very happy)"
+  ],
   "tags": [
     "emoji",
     "anger",

icons/annoyed.json

@@ -3,7 +3,10 @@
   "contributors": [
     "karsa-mistmere"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Expressing mild dissatisfaction in feedback or rating scales",
+    "Marking an unhappy step on a contentment scale (very unhappy to very happy)"
+  ],
   "tags": [
     "emoji",
     "nuisance",

icons/antenna.json

@@ -3,7 +3,11 @@
   "contributors": [
     "danielbayley"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Representing signal reception or broadcast",
+    "Indicating a TV antenna or terrestrial reception",
+    "Showing connectivity or frequency tuning"
+  ],
   "tags": [
     "signal",
     "connection",

icons/anvil.json

@@ -4,7 +4,9 @@
     "karsa-mistmere",
     "danielbayley"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Representing construction, metalwork, or industrial tools"
+  ],
   "tags": [
     "metal",
     "iron",

icons/aperture.json

@@ -4,7 +4,10 @@
     "colebemis",
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Representing camera aperture or exposure settings",
+    "Indicating photography or capture features"
+  ],
   "tags": [
     "camera",
     "photo",

icons/app-window-mac.json

@@ -3,7 +3,10 @@
   "contributors": [
     "danielbayley"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Representing an application window on macOS",
+    "Indicating a desktop app or pane"
+  ],
   "tags": [
     "application",
     "menu bar",

icons/app-window.json

@@ -4,7 +4,10 @@
     "danielbayley",
     "karsa-mistmere"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Representing an application window",
+    "Indicating a desktop app or executable"
+  ],
   "tags": [
     "application",
     "menu bar",

icons/apple.json

@@ -3,7 +3,11 @@
   "contributors": [
     "karsa-mistmere"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Representing fruit or healthy eating",
+    "Categorizing produce or groceries",
+    "Symbolizing nutrition or a balanced diet"
+  ],
   "tags": [
     "fruit",
     "food",

icons/archive-restore.json

@@ -5,7 +5,9 @@
     "ericfennis",
     "danielbayley"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Restoring an item from the archive, reversing an archive action"
+  ],
   "tags": [
     "unarchive",
     "index",

icons/archive-x.json

@@ -3,7 +3,10 @@
   "contributors": [
     "danielbayley"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Removing an item from the archive",
+    "Marking archived mail as junk"
+  ],
   "tags": [
     "index",
     "backup",

icons/archive.json

@@ -6,7 +6,10 @@
     "karsa-mistmere",
     "danielbayley"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Archiving items or moving them to storage",
+    "Representing backups or stored records"
+  ],
   "tags": [
     "index",
     "backup",

icons/armchair.json

@@ -4,7 +4,10 @@
     "karsa-mistmere",
     "jguddas"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Indicating a lounge or seating area in hotel and booking apps",
+    "Representing living room furniture in smart home applications"
+  ],
   "tags": [
     "sofa",
     "furniture",

icons/arrow-big-down-dash.json

@@ -6,7 +6,10 @@
     "jamiemlaw",
     "jguddas"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Moving down with emphasis, e.g. as a game control",
+    "Indicating a download or a jump to the bottom"
+  ],
   "tags": [
     "backwards",
     "reverse",

icons/arrow-big-down.json

@@ -8,7 +8,9 @@
     "jamiemlaw",
     "jguddas"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Indicating a strong downward direction, e.g. as a game control"
+  ],
   "tags": [
     "backwards",
     "reverse",

icons/arrow-big-left-dash.json

@@ -6,7 +6,9 @@
     "jamiemlaw",
     "jguddas"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Indicating a strong leftward direction or turn, e.g. as a game control"
+  ],
   "tags": [
     "previous",
     "back",

icons/arrow-big-left.json

@@ -9,7 +9,9 @@
     "jamiemlaw",
     "jguddas"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Indicating a strong leftward direction, e.g. as a game control"
+  ],
   "tags": [
     "previous",
     "back",

icons/arrow-big-right-dash.json

@@ -6,7 +6,9 @@
     "jamiemlaw",
     "jguddas"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Indicating a strong rightward direction or turn, e.g. as a game control"
+  ],
   "tags": [
     "next",
     "forward",

icons/arrow-big-right.json

@@ -9,7 +9,9 @@
     "jamiemlaw",
     "jguddas"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Indicating a strong rightward direction, e.g. as a game control"
+  ],
   "tags": [
     "next",
     "forward",

icons/arrow-big-up-dash.json

@@ -6,7 +6,10 @@
     "jamiemlaw",
     "jguddas"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Representing the Caps Lock key on a keyboard",
+    "Indicating a speed boost or strong upward direction in games"
+  ],
   "tags": [
     "caps lock",
     "capitals",

icons/arrow-big-up.json

@@ -8,7 +8,10 @@
     "jamiemlaw",
     "jguddas"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Representing the Shift key on a keyboard",
+    "Indicating a strong upward direction in games"
+  ],
   "tags": [
     "shift",
     "keyboard",

icons/arrow-down-0-1.json

@@ -4,7 +4,9 @@
     "karsa-mistmere",
     "danielbayley"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Sorting numerical values in ascending order"
+  ],
   "tags": [
     "filter",
     "sort",
@@ -25,8 +27,8 @@
     {
       "name": "arrow-down-01",
       "deprecationReason": "alias.name",
-      "deprecated": true,
-      "toBeRemovedInVersion": "v1.0"
-    }
+      "deprecated": true
+    },
+    "arrow-down-01"
   ]
 }

icons/arrow-down-1-0.json

@@ -4,7 +4,9 @@
     "karsa-mistmere",
     "danielbayley"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Sorting numerical values in descending order"
+  ],
   "tags": [
     "filter",
     "sort",
@@ -25,8 +27,8 @@
     {
       "name": "arrow-down-10",
       "deprecationReason": "alias.name",
-      "deprecated": true,
-      "toBeRemovedInVersion": "v1.0"
-    }
+      "deprecated": true
+    },
+    "arrow-down-10"
   ]
 }

icons/arrow-down-a-z.json

@@ -4,7 +4,9 @@
     "karsa-mistmere",
     "danielbayley"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Sorting items alphabetically from A to Z"
+  ],
   "tags": [
     "filter",
     "sort",
@@ -25,8 +27,8 @@
     {
       "name": "arrow-down-az",
       "deprecationReason": "alias.name",
-      "deprecated": true,
-      "toBeRemovedInVersion": "v1.0"
-    }
+      "deprecated": true
+    },
+    "arrow-down-az"
   ]
 }

icons/arrow-down-from-line.json

@@ -4,7 +4,10 @@
     "danielbayley",
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Downloading or moving content downward from a boundary",
+    "Expanding a section downward"
+  ],
   "tags": [
     "backwards",
     "reverse",

icons/arrow-down-left.json

@@ -4,7 +4,9 @@
     "colebemis",
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Indicating a downward-left diagonal direction"
+  ],
   "tags": [
     "direction",
     "south-west",

icons/arrow-down-narrow-wide.json

@@ -3,7 +3,9 @@
   "contributors": [
     "karsa-mistmere"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Sorting items from narrow to wide, e.g. smallest to largest"
+  ],
   "tags": [
     "filter",
     "sort",

icons/arrow-down-right.json

@@ -4,7 +4,9 @@
     "colebemis",
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Indicating a downward-right diagonal direction"
+  ],
   "tags": [
     "direction",
     "south-east",

icons/arrow-down-to-dot.json

@@ -3,7 +3,10 @@
   "contributors": [
     "danielbayley"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Moving down to a specific point or waypoint",
+    "Indicating a target or destination below"
+  ],
   "tags": [
     "direction",
     "south",

icons/arrow-down-to-line.json

@@ -4,7 +4,10 @@
     "danielbayley",
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Downloading or saving content to a boundary",
+    "Representing a git pull or collapsing a section"
+  ],
   "tags": [
     "behind",
     "direction",

icons/arrow-down-up.json

@@ -3,7 +3,10 @@
   "contributors": [
     "karsa-mistmere"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Indicating two-way data transfer or network traffic",
+    "Sorting or reordering items"
+  ],
   "tags": [
     "bidirectional",
     "two-way",

icons/arrow-down-wide-narrow.json

@@ -5,7 +5,9 @@
     "csandman",
     "karsa-mistmere"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Sorting items from wide to narrow, e.g. largest to smallest"
+  ],
   "tags": [
     "filter",
     "sort",
@@ -25,8 +27,7 @@
     {
       "name": "sort-desc",
       "deprecationReason": "alias.name",
-      "deprecated": true,
-      "toBeRemovedInVersion": "v1.0"
+      "deprecated": true
     }
   ]
 }

icons/arrow-down-z-a.json

@@ -4,7 +4,9 @@
     "karsa-mistmere",
     "danielbayley"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Sorting items alphabetically from Z to A"
+  ],
   "tags": [
     "filter",
     "sort",
@@ -26,8 +28,8 @@
     {
       "name": "arrow-down-za",
       "deprecationReason": "alias.name",
-      "deprecated": true,
-      "toBeRemovedInVersion": "v1.0"
-    }
+      "deprecated": true
+    },
+    "arrow-down-za"
   ]
 }

icons/arrow-down.json

@@ -4,7 +4,9 @@
     "colebemis",
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Indicating a downward direction or movement"
+  ],
   "tags": [
     "backwards",
     "reverse",

icons/arrow-left-from-line.json

@@ -4,7 +4,10 @@
     "danielbayley",
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Moving content left from a boundary",
+    "Expanding a section to the left"
+  ],
   "tags": [
     "previous",
     "back",

icons/arrow-left-right.json

@@ -4,7 +4,10 @@
     "wojtekmaj",
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Indicating a two-way or horizontal swap",
+    "Representing a transaction or exchange"
+  ],
   "tags": [
     "bidirectional",
     "two-way",

icons/arrow-left-to-line.json

@@ -4,7 +4,9 @@
     "danielbayley",
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Moving content left to a boundary or collapsing it"
+  ],
   "tags": [
     "previous",
     "back",

icons/arrow-left.json

@@ -4,7 +4,9 @@
     "colebemis",
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Indicating a leftward direction or going back"
+  ],
   "tags": [
     "previous",
     "back",

icons/arrow-right-from-line.json

@@ -4,7 +4,10 @@
     "danielbayley",
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Exporting or moving content right from a boundary",
+    "Expanding a section to the right"
+  ],
   "tags": [
     "next",
     "forward",

icons/arrow-right-left.json

@@ -3,7 +3,10 @@
   "contributors": [
     "karsa-mistmere"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Indicating a two-way or horizontal swap",
+    "Representing a transaction or exchange"
+  ],
   "tags": [
     "bidirectional",
     "two-way",

icons/arrow-right-to-line.json

@@ -4,7 +4,10 @@
     "danielbayley",
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Representing the Tab key or indenting content",
+    "Moving content right to a boundary"
+  ],
   "tags": [
     "next",
     "forward",

icons/arrow-right.json

@@ -4,7 +4,9 @@
     "colebemis",
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Indicating a rightward direction or moving forward"
+  ],
   "tags": [
     "forward",
     "next",

icons/arrow-up-0-1.json

@@ -4,7 +4,9 @@
     "karsa-mistmere",
     "danielbayley"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Sorting numerical values in ascending order"
+  ],
   "tags": [
     "filter",
     "sort",
@@ -25,8 +27,8 @@
     {
       "name": "arrow-up-01",
       "deprecationReason": "alias.name",
-      "deprecated": true,
-      "toBeRemovedInVersion": "v1.0"
-    }
+      "deprecated": true
+    },
+    "arrow-up-01"
   ]
 }

icons/arrow-up-1-0.json

@@ -4,7 +4,9 @@
     "karsa-mistmere",
     "danielbayley"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Sorting numerical values in descending order"
+  ],
   "tags": [
     "filter",
     "sort",
@@ -25,8 +27,8 @@
     {
       "name": "arrow-up-10",
       "deprecationReason": "alias.name",
-      "deprecated": true,
-      "toBeRemovedInVersion": "v1.0"
-    }
+      "deprecated": true
+    },
+    "arrow-up-10"
   ]
 }

icons/arrow-up-a-z.json

@@ -4,7 +4,9 @@
     "karsa-mistmere",
     "danielbayley"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Sorting items alphabetically from A to Z"
+  ],
   "tags": [
     "filter",
     "sort",
@@ -25,8 +27,8 @@
     {
       "name": "arrow-up-az",
       "deprecationReason": "alias.name",
-      "deprecated": true,
-      "toBeRemovedInVersion": "v1.0"
-    }
+      "deprecated": true
+    },
+    "arrow-up-az"
   ]
 }

icons/arrow-up-down.json

@@ -5,7 +5,10 @@
     "karsa-mistmere",
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Indicating two-way data transfer",
+    "Sorting or reordering items"
+  ],
   "tags": [
     "bidirectional",
     "two-way",

icons/arrow-up-from-dot.json

@@ -3,7 +3,10 @@
   "contributors": [
     "danielbayley"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Moving up and out from a point",
+    "Indicating an origin or starting point below"
+  ],
   "tags": [
     "direction",
     "north",

icons/arrow-up-from-line.json

@@ -4,7 +4,10 @@
     "danielbayley",
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Uploading or moving content upward from a boundary",
+    "Representing a git push"
+  ],
   "tags": [
     "forward",
     "direction",

icons/arrow-up-left.json

@@ -4,7 +4,9 @@
     "colebemis",
     "ericfennis"
   ],
-  "use-cases": [],
+  "use-cases": [
+    "Indicating an upward-left diagonal direction"
+  ],
   "tags": [
     "direction",
     "north-west",