chore(categories): Add description field to categories (#4909)

* Add category descriptions

Co-authored-by: ericfennis <11825403+ericfennis@users.noreply.github.com>

* Fix sports category icon

* Fix notifications category title

* Improve categories

* Update descriptions to include periods

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: ericfennis <11825403+ericfennis@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

categories/shapes.json

@@ -1,5 +1,6 @@
 {
   "$schema": "../category.schema.json",
   "title": "Shapes",
+  "description": "Icons for basic geometric shapes and symbols.",
   "icon": "triangle"
 }

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

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

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

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

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

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

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

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

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

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

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"

docs/.vitepress/lib/categories.ts

@@ -16,6 +16,7 @@ export function getAllCategoryFiles(): Omit<Category, 'iconCount'>[] {
     return {
       name,
       title: parsedFileContent.title,
+      description: parsedFileContent.description,
     };
   });
 }

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[];