quilrai · vaishnavs0 · Apr 2, 2026 · Apr 2, 2026 · Apr 2, 2026 · Apr 2, 2026
diff --git a/.cursor/rules/docs-icons.mdc b/.cursor/rules/docs-icons.mdc
@@ -0,0 +1,57 @@
+---
+description: Enforce sidebar icons on all documentation pages and categories
+globs: docs/**/*.md, docs/**/_category_.json
+alwaysApply: false
+---
+
+# Sidebar Icon Requirement
+
+Every doc page and category MUST have a sidebar icon from `lucide-react`.
+
+## Markdown pages (`docs/**/*.md`)
+
+Add `sidebar_custom_props` with an `icon` in frontmatter:
+
+```yaml
+---
+sidebar_position: 1
+sidebar_custom_props:
+  icon: Rocket
+---
+```
+
+## Category folders (`_category_.json`)
+
+Add `customProps` with an `icon`:
+
+```json
+{
+  "label": "Features",
+  "position": 3,
+  "customProps": {
+    "icon": "Sparkles"
+  }
+}
+```
+
+## Available icons
+
+Only use icons registered in `src/utils/sidebarIcons.js`:
+
+BookOpen, Network, BrainCircuit, Rocket, Layers, Sparkles, LibraryBig, Wrench, Bot, ShieldCheck, Lock, KeyRound, Link, Globe, Plug, Route, Coins, Target, Gauge, MessageSquareText, FlaskConical, Fingerprint, Activity, ClipboardList, Handshake
+
+## Adding a new icon
+
+If none of the above fit:
+
+1. Import the icon from `lucide-react` in `src/utils/sidebarIcons.js`
+2. Add it to `iconMap`
+3. Use the exact export name as the icon value
+
+Browse https://lucide.dev/icons to find appropriate icons.
+
+## Rules
+
+- NEVER create a doc page or category without an icon
+- Choose an icon that semantically matches the page content
+- After adding a new icon to `sidebarIcons.js`, use it immediately in the page frontmatter or `_category_.json`
diff --git a/.husky/pre-commit b/.husky/pre-commit
@@ -0,0 +1 @@
+node scripts/check-sidebar-icons.js --staged
diff --git a/docs/intro.md b/docs/intro.md
@@ -1,6 +1,8 @@
 ---
 sidebar_position: 1
 slug: /
+sidebar_custom_props:
+  icon: BookOpen
 ---
 
 # Welcome to QuilrAI Docs

diff --git a/docs/llm-gateway/_category_.json b/docs/llm-gateway/_category_.json
@@ -4,5 +4,8 @@
   "link": {
     "type": "generated-index",
     "description": "Unified API gateway for LLM providers - route, secure, monitor, and optimize all your LLM traffic through a single endpoint."
+  },
+  "customProps": {
+    "icon": "BrainCircuit"
   }
 }
diff --git a/docs/llm-gateway/architecture.md b/docs/llm-gateway/architecture.md
@@ -1,5 +1,7 @@
 ---
 sidebar_position: 2
+sidebar_custom_props:
+  icon: Layers
 ---
 
 # Architecture

diff --git a/docs/llm-gateway/features/_category_.json b/docs/llm-gateway/features/_category_.json
@@ -6,6 +6,7 @@
     "description": "Detailed documentation for each LLM Gateway capability - Routing, Token Saving, Guardrails, Prompt Store, Identity Aware, and more."
   },
   "customProps": {
-    "badge": "new"
+    "badge": "new",
+    "icon": "Sparkles"
   }
 }
diff --git a/docs/llm-gateway/features/custom-intents.md b/docs/llm-gateway/features/custom-intents.md
@@ -1,5 +1,7 @@
 ---
 sidebar_position: 5
+sidebar_custom_props:
+  icon: Target
 ---
 
 # Custom Intents

diff --git a/docs/llm-gateway/features/identity-aware.md b/docs/llm-gateway/features/identity-aware.md
@@ -1,5 +1,7 @@
 ---
 sidebar_position: 9
+sidebar_custom_props:
+  icon: Fingerprint
 ---
 
 # Identity Aware

diff --git a/docs/llm-gateway/features/prompt-store.md b/docs/llm-gateway/features/prompt-store.md
@@ -2,6 +2,7 @@
 sidebar_position: 7
 sidebar_custom_props:
   badge: new
+  icon: MessageSquareText
 ---
 
 # Prompt Store

diff --git a/docs/llm-gateway/features/rate-limits.md b/docs/llm-gateway/features/rate-limits.md
@@ -1,5 +1,7 @@
 ---
 sidebar_position: 6
+sidebar_custom_props:
+  icon: Gauge
 ---
 
 # Rate Limits

diff --git a/docs/llm-gateway/features/red-team-testing.md b/docs/llm-gateway/features/red-team-testing.md
@@ -1,5 +1,7 @@
 ---
 sidebar_position: 8
+sidebar_custom_props:
+  icon: FlaskConical
 ---
 
 # Red Team Testing

diff --git a/docs/llm-gateway/features/request-routing.md b/docs/llm-gateway/features/request-routing.md
@@ -1,5 +1,7 @@
 ---
 sidebar_position: 1
+sidebar_custom_props:
+  icon: Route
 ---
 
 # Request Routing

diff --git a/docs/llm-gateway/features/security-guardrails.md b/docs/llm-gateway/features/security-guardrails.md
@@ -1,5 +1,7 @@
 ---
 sidebar_position: 4
+sidebar_custom_props:
+  icon: ShieldCheck
 ---
 
 # Security Guardrails

diff --git a/docs/llm-gateway/features/token-saving.md b/docs/llm-gateway/features/token-saving.md
@@ -2,6 +2,7 @@
 sidebar_position: 2
 sidebar_custom_props:
   badge: new
+  icon: Coins
 ---
 
 # Token Saving

diff --git a/docs/llm-gateway/ha-and-sla.md b/docs/llm-gateway/ha-and-sla.md
@@ -2,6 +2,7 @@
 sidebar_position: 3
 sidebar_custom_props:
   badge: new
+  icon: Activity
 ---
 
 # HA & SLA

diff --git a/docs/llm-gateway/integration-guide.md b/docs/llm-gateway/integration-guide.md
@@ -1,5 +1,7 @@
 ---
 sidebar_position: 4
+sidebar_custom_props:
+  icon: Plug
 ---
 
 # Integration Guide

diff --git a/docs/llm-gateway/provider-support.md b/docs/llm-gateway/provider-support.md
@@ -1,5 +1,7 @@
 ---
 sidebar_position: 5
+sidebar_custom_props:
+  icon: Handshake
 ---
 
 # Provider Support

diff --git a/docs/llm-gateway/quick-start.md b/docs/llm-gateway/quick-start.md
@@ -1,5 +1,7 @@
 ---
 sidebar_position: 1
+sidebar_custom_props:
+  icon: Rocket
 ---
 
 # Quick Start

diff --git a/docs/llm-gateway/ux-changelog.md b/docs/llm-gateway/ux-changelog.md
@@ -1,5 +1,7 @@
 ---
 sidebar_position: 4
+sidebar_custom_props:
+  icon: ClipboardList
 ---
 
 # UX Changelog

diff --git a/docs/mcp-gateway/_category_.json b/docs/mcp-gateway/_category_.json
@@ -4,5 +4,8 @@
   "link": {
     "type": "generated-index",
     "description": "Enterprise-grade management layer for MCP servers - install, configure, secure, and monitor MCP integrations used by AI agents."
+  },
+  "customProps": {
+    "icon": "Network"
   }
 }
diff --git a/docs/mcp-gateway/architecture.md b/docs/mcp-gateway/architecture.md
@@ -1,5 +1,7 @@
 ---
 sidebar_position: 2
+sidebar_custom_props:
+  icon: Layers
 ---
 
 # Architecture

diff --git a/docs/mcp-gateway/features/_category_.json b/docs/mcp-gateway/features/_category_.json
@@ -6,6 +6,7 @@
     "description": "Detailed documentation for each MCP Gateway capability - MCP Library, Tools Management, Guardrails, Access Control, and more."
   },
   "customProps": {
-    "badge": "new"
+    "badge": "new",
+    "icon": "Sparkles"
   }
 }
diff --git a/docs/mcp-gateway/features/access-control.md b/docs/mcp-gateway/features/access-control.md
@@ -1,5 +1,7 @@
 ---
 sidebar_position: 5
+sidebar_custom_props:
+  icon: Lock
 ---
 
 # Access Control

diff --git a/docs/mcp-gateway/features/agents-configuration.md b/docs/mcp-gateway/features/agents-configuration.md
@@ -1,5 +1,7 @@
 ---
 sidebar_position: 3
+sidebar_custom_props:
+  icon: Bot
 ---
 
 # Agents Configuration

diff --git a/docs/mcp-gateway/features/api-tokens.md b/docs/mcp-gateway/features/api-tokens.md
@@ -1,5 +1,7 @@
 ---
 sidebar_position: 6
+sidebar_custom_props:
+  icon: KeyRound
 ---
 
 # API Tokens

diff --git a/docs/mcp-gateway/features/mcp-library.md b/docs/mcp-gateway/features/mcp-library.md
@@ -2,6 +2,7 @@
 sidebar_position: 1
 sidebar_custom_props:
   badge: new
+  icon: LibraryBig
 ---
 
 # MCP Library

diff --git a/docs/mcp-gateway/features/oauth-connect.md b/docs/mcp-gateway/features/oauth-connect.md
@@ -1,5 +1,7 @@
 ---
 sidebar_position: 7
+sidebar_custom_props:
+  icon: Link
 ---
 
 # OAuth Connect

diff --git a/docs/mcp-gateway/features/security-guardrails.md b/docs/mcp-gateway/features/security-guardrails.md
@@ -1,5 +1,7 @@
 ---
 sidebar_position: 4
+sidebar_custom_props:
+  icon: ShieldCheck
 ---
 
 # Security Guardrails

diff --git a/docs/mcp-gateway/features/tools-management.md b/docs/mcp-gateway/features/tools-management.md
@@ -1,5 +1,7 @@
 ---
 sidebar_position: 2
+sidebar_custom_props:
+  icon: Wrench
 ---
 
 # Tools Management

diff --git a/docs/mcp-gateway/features/web-search-policy.md b/docs/mcp-gateway/features/web-search-policy.md
@@ -2,6 +2,7 @@
 sidebar_position: 8
 sidebar_custom_props:
   badge: new
+  icon: Globe
 ---
 
 # Web Search Policy

diff --git a/docs/mcp-gateway/integration-guide.md b/docs/mcp-gateway/integration-guide.md
@@ -1,5 +1,7 @@
 ---
 sidebar_position: 3
+sidebar_custom_props:
+  icon: Plug
 ---
 
 # Integration Guide

diff --git a/docs/mcp-gateway/quick-start.md b/docs/mcp-gateway/quick-start.md
@@ -1,5 +1,7 @@
 ---
 sidebar_position: 1
+sidebar_custom_props:
+  icon: Rocket
 ---
 
 # Quick Start

diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -11,7 +11,9 @@
     "clear": "docusaurus clear",
     "serve": "docusaurus serve",
     "write-translations": "docusaurus write-translations",
-    "write-heading-ids": "docusaurus write-heading-ids"
+    "write-heading-ids": "docusaurus write-heading-ids",
+    "check-icons": "node scripts/check-sidebar-icons.js",
+    "prepare": "husky"
   },
   "dependencies": {
     "@docusaurus/core": "3.9.2",
@@ -22,6 +24,7 @@
     "@fontsource/geist-mono": "^5.2.7",
     "@mdx-js/react": "^3.0.0",
     "clsx": "^2.0.0",
+    "lucide-react": "^1.7.0",
     "prism-react-renderer": "^2.3.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
@@ -31,6 +34,7 @@
     "@docusaurus/types": "3.9.2",
     "@tailwindcss/postcss": "^4.2.2",
     "@tailwindcss/typography": "^0.5.19",
+    "husky": "^9.1.7",
     "tailwindcss": "^4.2.2"
   },
   "browserslist": {