diff --git a/docs/.vitepress/theme/components/home/HomeHeroBefore.data.ts b/docs/.vitepress/theme/components/home/HomeHeroBefore.data.ts
index e235048e3..76b2c3a6d 100644
--- a/docs/.vitepress/theme/components/home/HomeHeroBefore.data.ts
+++ b/docs/.vitepress/theme/components/home/HomeHeroBefore.data.ts
@@ -9,7 +9,7 @@ export default {
         }
         return null;
       })
-      .then((res) => res.tag_name);
+      .then((res) => res?.tag_name);
 
     return {
       version,
diff --git a/docs/.vitepress/theme/components/icons/IconShowcase.vue b/docs/.vitepress/theme/components/icons/IconShowcase.vue
new file mode 100644
index 000000000..a3a9cc25f
--- /dev/null
+++ b/docs/.vitepress/theme/components/icons/IconShowcase.vue
@@ -0,0 +1,438 @@
+<script setup lang="ts">
+import type { IconEntity } from '../../types';
+import { computed } from 'vue';
+import createLucideIcon from 'lucide-vue-next/src/createLucideIcon.ts';
+import Calendar from '../../../data/iconDetails/calendar.ts';
+import Clock from '../../../data/iconDetails/clock.ts';
+import Bug from '../../../data/iconDetails/bug.ts';
+import Rocket from '../../../data/iconDetails/rocket.ts';
+import TriangleAlert from '../../../data/iconDetails/triangle-alert.ts';
+import PartyPopper from '../../../data/iconDetails/party-popper.ts';
+import Scissors from '../../../data/iconDetails/scissors.ts';
+import Copy from '../../../data/iconDetails/copy.ts';
+import Save from '../../../data/iconDetails/save.ts';
+import Clipboard from '../../../data/iconDetails/clipboard.ts';
+import MessageCircle from '../../../data/iconDetails/message-circle.ts';
+import ThumbsDown from '../../../data/iconDetails/thumbs-down.ts';
+import ThumbsUp from '../../../data/iconDetails/thumbs-up.ts';
+import Heart from '../../../data/iconDetails/heart.ts';
+import Folder from '../../../data/iconDetails/folder.ts';
+import Files from '../../../data/iconDetails/files.ts';
+import Plus from '../../../data/iconDetails/plus.ts';
+import File from '../../../data/iconDetails/file.ts';
+import FileText from '../../../data/iconDetails/file-text.ts';
+
+const props = defineProps<{
+  name: IconEntity['name'];
+  iconNode: IconEntity['iconNode'];
+}>();
+
+const iconComponent = computed(() => {
+  if (!props.name || !props.iconNode) return null;
+  return createLucideIcon(props.name, props.iconNode);
+});
+
+const CalendarIcon = createLucideIcon('calendar', Calendar.iconNode);
+const ClockIcon = createLucideIcon('clock', Clock.iconNode);
+const BugIcon = createLucideIcon('bug', Bug.iconNode);
+const RocketIcon = createLucideIcon('rocket', Rocket.iconNode);
+const AlertTriangleIcon = createLucideIcon('alert-triangle', TriangleAlert.iconNode);
+const ScissorsIcon = createLucideIcon('scissors', Scissors.iconNode);
+const CopyIcon = createLucideIcon('copy', Copy.iconNode);
+const SaveIcon = createLucideIcon('save', Save.iconNode);
+const ClipboardIcon = createLucideIcon('clipboard', Clipboard.iconNode);
+const PartyPopperIcon = createLucideIcon('party-popper', PartyPopper.iconNode);
+const HeartIcon = createLucideIcon('heart', Heart.iconNode);
+const ThumbsUpIcon = createLucideIcon('thumbs-up', ThumbsUp.iconNode);
+const ThumbsDownIcon = createLucideIcon('thumbs-down', ThumbsDown.iconNode);
+const MessageCircleIcon = createLucideIcon('message-circle', MessageCircle.iconNode);
+const FolderIcon = createLucideIcon('folder.ts', Folder.iconNode);
+const FilesIcon = createLucideIcon('files.ts', Files.iconNode);
+const PlusIcon = createLucideIcon('plus.ts', Plus.iconNode);
+const FileIcon = createLucideIcon('file.ts', File.iconNode);
+const FileTextIcon = createLucideIcon('file-text.ts', FileText.iconNode);
+
+const prettyName = props.name
+  .split('-')
+  .at(0)
+  .split('')
+  .map((character, index) => (index === 0 ? character.toUpperCase() : character))
+  .join('');
+</script>
+
+<template>
+  <section class="showcase">
+    <h2 class="title">See this icon in action</h2>
+    <div class="showcase-grid">
+      <div class="showcase-item column">
+        <div class="placeholder"></div>
+        <div class="placeholder"></div>
+        <div class="placeholder"></div>
+        <div class="placeholder narrow"></div>
+        <div class="spacer"></div>
+        <div class="actions">
+          <button class="button button-brand">
+            <iconComponent />
+            {{ prettyName }}
+          </button>
+          <button class="button button-alt">Cancel</button>
+        </div>
+      </div>
+      <div class="showcase-item column">
+        <div class="placeholder narrow"></div>
+        <div class="input-wrapper">
+          <CalendarIcon v-if="name !== 'calendar'" />
+          <ClockIcon v-if="name == 'calendar'" />
+          <input
+            type="text"
+            v-if="name !== 'calendar'"
+            placeholder="Enter a date..."
+          />
+          <input
+            type="text"
+            v-if="name == 'calendar'"
+            placeholder="Enter a time..."
+          />
+        </div>
+        <div class="spacer"></div>
+        <div class="placeholder narrow"></div>
+        <div class="input-wrapper">
+          <iconComponent />
+          <input
+            type="text"
+            placeholder="Enter a value..."
+          />
+        </div>
+      </div>
+      <div class="showcase-item column">
+        <div
+          class="row"
+          v-if="name !== 'bug'"
+        >
+          <div class="placeholder"></div>
+          <div class="badge badge-red">
+            <BugIcon :size="20" />
+            Bug
+          </div>
+        </div>
+        <div
+          class="row"
+          v-else
+        >
+          <div class="placeholder"></div>
+          <div class="badge badge-red">
+            <AlertTriangleIcon :size="20" />
+            Alert
+          </div>
+        </div>
+        <div class="row">
+          <div class="placeholder"></div>
+          <div class="badge badge-indigo">
+            <RocketIcon
+              :size="20"
+              v-if="name !== 'rocket'"
+            />
+            <PartyPopperIcon
+              :size="20"
+              v-else
+            />
+            Feature
+          </div>
+        </div>
+        <div class="row">
+          <div class="placeholder"></div>
+          <div class="badge badge-green">
+            <iconComponent :size="20" />
+            {{ prettyName }}
+          </div>
+        </div>
+      </div>
+      <div class="showcase-item column">
+        <button class="button button-alt button-square">
+          <FolderIcon v-if="name !== 'folder'" />
+          <FilesIcon v-else />
+          Documents
+          <PlusIcon class="ms-auto" />
+        </button>
+        <button class="button button-alt button-square">
+          <FileIcon v-if="name !== 'file'" />
+          <FileTextIcon v-else />
+          Readme
+        </button>
+        <button class="button button-alt button-square">
+          <iconComponent />
+          {{ prettyName }}
+          <span class="badge-notification ms-auto">12</span>
+        </button>
+      </div>
+      <div class="showcase-item column">
+        <div class="placeholder"></div>
+        <div class="placeholder"></div>
+        <div class="placeholder"></div>
+        <div class="placeholder narrow"></div>
+        <div class="spacer"></div>
+        <div class="actions">
+          <div class="icon-counter">
+            <HeartIcon v-if="name !== 'heart'" />
+            <ThumbsUpIcon v-else />
+            112
+          </div>
+          <div class="spacer"></div>
+          <div class="icon-counter">
+            <MessageCircleIcon v-if="name !== 'message-circle'" />
+            <ThumbsDownIcon v-else />
+            8
+          </div>
+          <div class="spacer"></div>
+          <div class="icon-counter">
+            <iconComponent />
+            11
+          </div>
+        </div>
+      </div>
+      <div class="showcase-item">
+        <div class="column align-items-center">
+          <div class="actions justify-content-center">
+            <button class="button button-icon">
+              <CopyIcon v-if="name !== 'copy'" />
+              <SaveIcon v-else />
+            </button>
+            <button class="button button-icon">
+              <ScissorsIcon v-if="name !== 'scissors'" />
+              <SaveIcon v-else />
+            </button>
+            <button class="button button-icon">
+              <ClipboardIcon v-if="name !== 'clipboard'" />
+              <SaveIcon v-else />
+            </button>
+            <button class="button button-icon">
+              <iconComponent></iconComponent>
+              <span class="badge-notification">2</span>
+            </button>
+          </div>
+          <div class="spacer"></div>
+          <div class="placeholder"></div>
+          <div class="placeholder"></div>
+          <div class="placeholder"></div>
+        </div>
+      </div>
+    </div>
+  </section>
+</template>
+
+<style scoped>
+.showcase {
+  margin-bottom: 32px;
+}
+
+.showcase-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(320px, 1fr));
+  gap: 48px;
+  margin-inline-start: 24px;
+  margin-block-start: 48px;
+}
+
+.showcase-item {
+  padding: 24px;
+  border-radius: 8px;
+  background-color: var(--vp-c-bg);
+  box-shadow:
+    var(--vp-shadow-4),
+    -24px -24px 0 var(--vp-c-bg-soft);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  min-height: 240px;
+}
+
+.spacer {
+  flex-basis: 0;
+}
+
+.button {
+  position: relative;
+  border-radius: 32px;
+  padding: 8px 16px;
+  display: flex;
+  flex-direction: row;
+  gap: 12px;
+  font-weight: 500;
+  transition:
+    color 0.25s,
+    border-color 0.25s,
+    background-color 0.25s;
+
+  border-color: var(--vp-button-alt-border);
+  color: var(--vp-button-alt-text);
+  background-color: var(--vp-button-alt-bg);
+  &:hover {
+    border-color: var(--vp-button-alt-hover-border);
+    color: var(--vp-button-alt-hover-text);
+    background-color: var(--vp-button-alt-hover-bg);
+  }
+  &.button-brand {
+    border-color: var(--vp-button-brand-border);
+    color: var(--vp-button-brand-text);
+    background-color: var(--vp-button-brand-bg);
+    &:hover {
+      border-color: var(--vp-button-brand-hover-border);
+      color: var(--vp-button-brand-hover-text);
+      background-color: var(--vp-button-brand-hover-bg);
+    }
+  }
+  &.button-icon {
+    padding: 12px;
+  }
+  &.button-square {
+    border-radius: 8px;
+    width: 100%;
+  }
+}
+
+.actions {
+  display: flex;
+  flex-direction: row;
+  flex-wrap: wrap;
+  gap: 12px;
+}
+
+.lucide {
+  flex-shrink: 0;
+  flex-grow: 0;
+}
+
+.placeholder {
+  display: block;
+  background-color: var(--vp-c-bg-soft);
+  border-radius: 32px;
+  height: 16px;
+  width: 100%;
+
+  &.narrow {
+    width: 33%;
+  }
+}
+
+.input-wrapper {
+  position: relative;
+  width: 100%;
+  .lucide {
+    position: absolute;
+    inset-inline-start: 12px;
+    inset-block: 50%;
+    translate: 0 -50%;
+    color: var(--vp-c-text-1);
+    opacity: 0.7;
+  }
+  input {
+    padding: 12px 20px;
+    padding-inline-start: 48px;
+    border-radius: 8px;
+    background-color: var(--vp-c-bg-soft);
+    color: var(--vp-c-text-1);
+    display: block;
+    width: 100%;
+    border: 2px solid transparent;
+    transition:
+      color 0.25s,
+      border-color 0.25s,
+      background-color 0.25s;
+    &:hover {
+      border-color: var(--vp-c-border);
+    }
+    &:focus {
+      border-color: var(--vp-c-brand);
+    }
+  }
+  &:focus-within {
+    .lucide {
+      opacity: 1;
+    }
+  }
+}
+
+.badge {
+  flex-shrink: 0;
+  display: flex;
+  flex-direction: row;
+  align-items: center;
+  gap: 6px;
+  padding: 4px 8px;
+  border-radius: 8px;
+  background-color: transparent;
+  overflow: hidden;
+  position: relative;
+  color: var(--badge-color);
+  &:before {
+    content: ' ';
+    inset: 0;
+    position: absolute;
+    background-color: var(--badge-color);
+    opacity: 0.1;
+  }
+  &.badge-indigo {
+    --badge-color: var(--vp-c-indigo-2);
+  }
+  &.badge-green {
+    --badge-color: var(--vp-c-green-2);
+  }
+  &.badge-red {
+    --badge-color: var(--vp-c-brand);
+  }
+}
+
+.badge-notification {
+  background-color: var(--vp-c-brand);
+  color: var(--vp-button-brand-text);
+  border-radius: 32px;
+  padding: 0 8px;
+  min-width: 24px;
+  min-height: 24px;
+}
+
+.button-icon {
+  .badge-notification {
+    position: absolute;
+    top: 0;
+    right: 0;
+    translate: 33% -33%;
+  }
+}
+
+.row {
+  display: flex;
+  flex-direction: row;
+  gap: 12px;
+  align-items: center;
+  width: 100%;
+}
+
+.icon-counter {
+  display: flex;
+  flex-direction: row;
+  gap: 6px;
+  color: var(--vp-c-text-2);
+  align-items: center;
+}
+
+.column {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  align-items: start;
+  width: 100%;
+}
+
+.align-items-center {
+  align-items: center;
+}
+
+.justify-content-center {
+  justify-content: center;
+}
+
+.ms-auto {
+  margin-inline-start: auto;
+}
+</style>
diff --git a/docs/.vitepress/theme/components/icons/RelatedIcons.vue b/docs/.vitepress/theme/components/icons/RelatedIcons.vue
index 47f470d7e..41af54f72 100644
--- a/docs/.vitepress/theme/components/icons/RelatedIcons.vue
+++ b/docs/.vitepress/theme/components/icons/RelatedIcons.vue
@@ -1,29 +1,20 @@
 <script setup lang="ts">
-import type { IconEntity } from '../../types'
-import IconGrid from './IconGrid.vue'
+import type { IconEntity } from '../../types';
+import IconGrid from './IconGrid.vue';
+
 defineProps<{
-  icons: IconEntity[]
-}>()
+  icons: IconEntity[];
+}>();
 </script>
 
 <template>
   <section class="related-icons">
-    <h2 class="title">
-      Related Icons
-    </h2>
-    <IconGrid
-      :icons="icons"
-    />
+    <h2 class="title">More icons like this</h2>
+    <IconGrid :icons="icons" />
   </section>
 </template>
 
 <style scoped>
-.title {
-  margin-bottom: 24px;
-  font-size: 19px;
-  font-weight: 500;
-}
-
 .related-icons {
   margin-bottom: 32px;
 }
diff --git a/docs/icons/[name].md b/docs/icons/[name].md
index f69e966c3..7ea8700e0 100644
--- a/docs/icons/[name].md
+++ b/docs/icons/[name].md
@@ -14,6 +14,7 @@ import IconPreview from '~/.vitepress/theme/components/icons/IconPreview.vue'
 import IconPreviewSmall from '~/.vitepress/theme/components/icons/IconPreviewSmall.vue'
 import IconInfo from '~/.vitepress/theme/components/icons/IconInfo.vue'
 import IconContributors from '~/.vitepress/theme/components/icons/IconContributors.vue'
+import IconShowcase from '~/.vitepress/theme/components/icons/IconShowcase.vue'
 import RelatedIcons from '~/.vitepress/theme/components/icons/RelatedIcons.vue'
 import CodeGroup from '~/.vitepress/theme/components/base/CodeGroup.vue'
 import Badge from '~/.vitepress/theme/components/base/Badge.vue'
@@ -104,6 +105,11 @@ function releaseTagLink(version) {
   </div>
 </div>
 
+<IconShowcase
+  :name="params.name"
+  :iconNode="params.iconNode"
+/>
+
 <RelatedIcons
   v-if="params.relatedIcons"
   :icons="params.relatedIcons"
@@ -233,3 +239,12 @@ function releaseTagLink(version) {
     }
   }
 </style>
+
+<style>
+section h2.title {
+  text-align: center;
+  font-weight: 500;
+  margin-block-end: 64px;
+  padding-top: 32px;
+}
+</style>