diff --git a/categories/accessibility.json b/categories/accessibility.json
index a668d3ee3..e6a4cc76a 100644
--- a/categories/accessibility.json
+++ b/categories/accessibility.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Accessibility",
+  "description": "Icons for accessibility, visibility, hearing, speech, and inclusive UI affordances.",
   "icon": "accessibility"
 }
diff --git a/categories/account.json b/categories/account.json
index 95a80ad40..cc903fddd 100644
--- a/categories/account.json
+++ b/categories/account.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Accounts & access",
+  "description": "Icons for user profiles, identity, settings, memberships, and personal account actions.",
   "icon": "user"
 }
diff --git a/categories/animals.json b/categories/animals.json
index 85fafda5f..f1cff48ec 100644
--- a/categories/animals.json
+++ b/categories/animals.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Animals",
+  "description": "Icons for animals, wildlife, pets, insects, and other living creatures.",
   "icon": "dog"
 }
diff --git a/categories/arrows.json b/categories/arrows.json
index 3258378f9..b42d13038 100644
--- a/categories/arrows.json
+++ b/categories/arrows.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Arrows",
+  "description": "Icons for directional arrows, movement, sorting, transfer, and navigation flows.",
   "icon": "arrow-left-right"
 }
diff --git a/categories/buildings.json b/categories/buildings.json
index 13f24b08f..cd6d424c7 100644
--- a/categories/buildings.json
+++ b/categories/buildings.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Buildings",
+  "description": "Icons for buildings, landmarks, houses, infrastructure, and built environments.",
   "icon": "building"
 }
diff --git a/categories/charts.json b/categories/charts.json
index e9bdc1882..8d37c9e26 100644
--- a/categories/charts.json
+++ b/categories/charts.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Charts",
+  "description": "Icons for charts, graphs, trends, analytics, and data visualization.",
   "icon": "chart-pie"
 }
diff --git a/categories/communication.json b/categories/communication.json
index 3b9a899d7..cc22a29d4 100644
--- a/categories/communication.json
+++ b/categories/communication.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Communication",
+  "description": "Icons for speaking, listening, calling, messaging, broadcasting, and communication devices.",
   "icon": "message-circle"
 }
diff --git a/categories/connectivity.json b/categories/connectivity.json
index b566a84ec..1568ff2da 100644
--- a/categories/connectivity.json
+++ b/categories/connectivity.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Connectivity",
+  "description": "Icons for wireless signals, wired connections, networks, device pairing, and data transfer.",
   "icon": "wifi"
 }
diff --git a/categories/cursors.json b/categories/cursors.json
index 9522faa16..5996828a7 100644
--- a/categories/cursors.json
+++ b/categories/cursors.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Cursors",
+  "description": "Icons for cursors, pointers, selection tools, and loading states.",
   "icon": "mouse-pointer-2"
 }
diff --git a/categories/design.json b/categories/design.json
index e32592560..bddae399e 100644
--- a/categories/design.json
+++ b/categories/design.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Design",
+  "description": "Icons for design tools, layout controls, creative editing, and visual composition.",
   "icon": "palette"
 }
diff --git a/categories/development.json b/categories/development.json
index 113fd1cc2..beb75b795 100644
--- a/categories/development.json
+++ b/categories/development.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Coding & development",
+  "description": "Icons for code, logic, data structures, automation, and software development workflows.",
   "icon": "code-xml"
 }
diff --git a/categories/devices.json b/categories/devices.json
index 3bb54f180..d6131a952 100644
--- a/categories/devices.json
+++ b/categories/devices.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Devices",
+  "description": "Icons for hardware, electronics, computers, peripherals, and connected devices.",
   "icon": "smartphone"
 }
diff --git a/categories/emoji.json b/categories/emoji.json
index 2bd590877..78e838828 100644
--- a/categories/emoji.json
+++ b/categories/emoji.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Emoji",
+  "description": "Icons for expressive symbols, faces, gestures, hearts, stars, and zodiac signs.",
   "icon": "face-slightly-smiling"
 }
diff --git a/categories/files.json b/categories/files.json
index 073a09beb..40b4265e8 100644
--- a/categories/files.json
+++ b/categories/files.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "File icons",
+  "description": "Icons for files, folders, storage, import and export, and document-related actions.",
   "icon": "panels-top-left"
 }
diff --git a/categories/finance.json b/categories/finance.json
index 267643671..b89e9c126 100644
--- a/categories/finance.json
+++ b/categories/finance.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Finance",
+  "description": "Icons for money, pricing, payments, currencies, banking, and financial trends.",
   "icon": "piggy-bank"
 }
diff --git a/categories/food-beverage.json b/categories/food-beverage.json
index 7456558b6..f643fcbb3 100644
--- a/categories/food-beverage.json
+++ b/categories/food-beverage.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Food & beverage",
+  "description": "Icons for food, drinks, cooking, ingredients, dining, and kitchen items.",
   "icon": "coffee"
 }
diff --git a/categories/gaming.json b/categories/gaming.json
index 2c90f4c9d..c9f5e47f5 100644
--- a/categories/gaming.json
+++ b/categories/gaming.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Gaming",
+  "description": "Icons for games, fantasy items, strategy pieces, achievements, and play-related objects.",
   "icon": "gamepad-2"
 }
diff --git a/categories/home.json b/categories/home.json
index 20a89330d..d15228e3d 100644
--- a/categories/home.json
+++ b/categories/home.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Home",
+  "description": "Icons for household spaces, furniture, appliances, utilities, cleaning, and home safety.",
   "icon": "house"
 }
diff --git a/categories/layout.json b/categories/layout.json
index 22a163f95..ba9ffbe34 100644
--- a/categories/layout.json
+++ b/categories/layout.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Layout",
+  "description": "Icons for alignment, spacing, resizing, grouping, and interface layout structure.",
   "icon": "panels-top-left"
 }
diff --git a/categories/mail.json b/categories/mail.json
index 3dd1d3026..329a55ed1 100644
--- a/categories/mail.json
+++ b/categories/mail.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Mail",
+  "description": "Icons for mailboxes, inboxes, sending, replies, attachments, and email management.",
   "icon": "mail"
 }
diff --git a/categories/math.json b/categories/math.json
index 1ae72ad9e..19d8fe569 100644
--- a/categories/math.json
+++ b/categories/math.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Mathematics",
+  "description": "Icons for math symbols, geometry, measurement, arithmetic, and calculation.",
   "icon": "divide"
 }
diff --git a/categories/medical.json b/categories/medical.json
index e745df697..fcc92c78d 100644
--- a/categories/medical.json
+++ b/categories/medical.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Medical",
+  "description": "Icons for healthcare, anatomy, treatment, diagnostics, wellness, and medical facilities.",
   "icon": "heart"
 }
diff --git a/categories/multimedia.json b/categories/multimedia.json
index 00897c3e4..80907bdf8 100644
--- a/categories/multimedia.json
+++ b/categories/multimedia.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Multimedia",
+  "description": "Icons for audio, video, playback, recording, broadcasting, and media libraries.",
   "icon": "circle-play"
 }
diff --git a/categories/nature.json b/categories/nature.json
index aa41fd8dd..5f83e3778 100644
--- a/categories/nature.json
+++ b/categories/nature.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Nature",
+  "description": "Icons for plants, trees, landscapes, camping, and the natural world.",
   "icon": "sprout"
 }
diff --git a/categories/navigation.json b/categories/navigation.json
index 0c46693cb..4542bfdd7 100644
--- a/categories/navigation.json
+++ b/categories/navigation.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Navigation & Places",
+  "description": "Icons for maps, locations, landmarks, routes, travel directions, and wayfinding.",
   "icon": "compass"
 }
diff --git a/categories/notifications.json b/categories/notifications.json
index c2a729bec..366c4efbe 100644
--- a/categories/notifications.json
+++ b/categories/notifications.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
-  "title": "Notification",
+  "title": "Notifications",
+  "description": "Icons for alerts, status updates, reminders, approvals, and attention states.",
   "icon": "triangle-alert"
 }
diff --git a/categories/people.json b/categories/people.json
index be028e4b5..a8378b7f4 100644
--- a/categories/people.json
+++ b/categories/people.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "People",
+  "description": "Icons for people, groups, identities, roles, and person-centered actions.",
   "icon": "person-standing"
 }
diff --git a/categories/photography.json b/categories/photography.json
index a4ad5bff1..fcaa4f42f 100644
--- a/categories/photography.json
+++ b/categories/photography.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Photography",
+  "description": "Icons for cameras, images, framing, viewing, editing, and photo workflows.",
   "icon": "camera"
 }
diff --git a/categories/science.json b/categories/science.json
index 720983fb3..27988158d 100644
--- a/categories/science.json
+++ b/categories/science.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Science",
+  "description": "Icons for science, research, experiments, instruments, formulas, and discovery.",
   "icon": "flask-conical"
 }
diff --git a/categories/seasons.json b/categories/seasons.json
index 0c4fff3cc..43ab65678 100644
--- a/categories/seasons.json
+++ b/categories/seasons.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Seasons",
+  "description": "Icons for seasonal weather, blooming plants, sunlight, and changing times of year.",
   "icon": "leaf"
 }
diff --git a/categories/security.json b/categories/security.json
index 8372554fe..f8fc17cfc 100644
--- a/categories/security.json
+++ b/categories/security.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Security",
+  "description": "Icons for locks, keys, identity checks, surveillance, protection, and secure access.",
   "icon": "shield"
 }
diff --git a/categories/shapes.json b/categories/shapes.json
index c968b222b..d282fcd2a 100644
--- a/categories/shapes.json
+++ b/categories/shapes.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Shapes",
+  "description": "Icons for basic geometric shapes and symbols.",
   "icon": "triangle"
 }
diff --git a/categories/shopping.json b/categories/shopping.json
index 5e6b05ff5..b9341196c 100644
--- a/categories/shopping.json
+++ b/categories/shopping.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Shopping",
+  "description": "Icons for retail, carts, bags, checkout, barcodes, and purchasing.",
   "icon": "shopping-bag"
 }
diff --git a/categories/social.json b/categories/social.json
index ee87f8574..ce0210600 100644
--- a/categories/social.json
+++ b/categories/social.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Social",
+  "description": "Icons for social interaction, reactions, sharing, community, and relationship signals.",
   "icon": "thumbs-up"
 }
diff --git a/categories/sports.json b/categories/sports.json
index 25440ad6f..aff648ab4 100644
--- a/categories/sports.json
+++ b/categories/sports.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Sports",
-  "icon": "type"
+  "description": "Icons for sports, fitness, competition, equipment, and athletic achievement.",
+  "icon": "trophy"
 }
diff --git a/categories/sustainability.json b/categories/sustainability.json
index a0730f6fa..c18463168 100644
--- a/categories/sustainability.json
+++ b/categories/sustainability.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Sustainability",
+  "description": "Icons for sustainability, clean energy, recycling, nature, and environmental stewardship.",
   "icon": "recycle"
 }
diff --git a/categories/text.json b/categories/text.json
index 74419487a..49d19130d 100644
--- a/categories/text.json
+++ b/categories/text.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Text formatting",
+  "description": "Icons for letters, typography, formatting, reading, writing, and text structure.",
   "icon": "type"
 }
diff --git a/categories/time.json b/categories/time.json
index 2b85210de..703402f79 100644
--- a/categories/time.json
+++ b/categories/time.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Time & calendar",
+  "description": "Icons for clocks, calendars, schedules, history, timers, and time tracking.",
   "icon": "calendar"
 }
diff --git a/categories/tools.json b/categories/tools.json
index 48cf0a96a..18722dd6e 100644
--- a/categories/tools.json
+++ b/categories/tools.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Tools",
+  "description": "Icons for hand tools, equipment, maintenance, repair, and making things.",
   "icon": "hammer"
 }
diff --git a/categories/transportation.json b/categories/transportation.json
index 984da071c..768fa6a81 100644
--- a/categories/transportation.json
+++ b/categories/transportation.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Transportation",
+  "description": "Icons for vehicles, transit, cargo, parking, fuel, and moving people or goods.",
   "icon": "train-front"
 }
diff --git a/categories/travel.json b/categories/travel.json
index 3d78c06e3..cf7081470 100644
--- a/categories/travel.json
+++ b/categories/travel.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Travel",
+  "description": "Icons for travel, lodging, luggage, destinations, trip planning, and tourism.",
   "icon": "backpack"
 }
diff --git a/categories/weather.json b/categories/weather.json
index a08cc5d66..72c9b0338 100644
--- a/categories/weather.json
+++ b/categories/weather.json
@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Weather",
+  "description": "Icons for clouds, sun, rain, wind, temperature, and weather conditions.",
   "icon": "cloud-sun"
 }
diff --git a/category.schema.json b/category.schema.json
index 7229f210e..385d1f14c 100644
--- a/category.schema.json
+++ b/category.schema.json
@@ -13,7 +13,7 @@
   "title": "Lucide Icons category schema",
   "type": "object",
   "additionalProperties": false,
-  "required": ["$schema", "icon", "title"],
+  "required": ["$schema", "description", "icon", "title"],
   "properties": {
     "$schema": {
       "type": "string"
diff --git a/docs/.vitepress/lib/categories.ts b/docs/.vitepress/lib/categories.ts
index 71d551b5a..10f5daf3a 100644
--- a/docs/.vitepress/lib/categories.ts
+++ b/docs/.vitepress/lib/categories.ts
@@ -16,6 +16,7 @@ export function getAllCategoryFiles(): Omit<Category, 'iconCount'>[] {
     return {
       name,
       title: parsedFileContent.title,
+      description: parsedFileContent.description,
     };
   });
 }
diff --git a/docs/.vitepress/theme/types.ts b/docs/.vitepress/theme/types.ts
index 4ad1664bb..dcd140394 100644
--- a/docs/.vitepress/theme/types.ts
+++ b/docs/.vitepress/theme/types.ts
@@ -32,6 +32,7 @@ export interface IconEntity extends IconMetaData {
 export interface Category {
   name: string;
   title: string;
+  description: string;
   icon?: string;
   iconCount: number;
   icons?: IconEntity[];