From 5f78ab02a9aa8fbb8ce8403ff8b8eb550ca57685 Mon Sep 17 00:00:00 2001
From: aaombase <aaombase@gmail.com>
Date: Fri, 1 May 2026 17:33:20 +0530
Subject: [PATCH] docs: add JSDoc to useDebounce hook

---
 web/client/src/App.jsx               | 4 ++++
 web/client/src/components/Navbar.jsx | 3 +++
 web/client/src/hooks/useDebounce.js  | 6 ++++++
 3 files changed, 13 insertions(+)

diff --git a/web/client/src/App.jsx b/web/client/src/App.jsx
index 338cefd..67e1407 100644
--- a/web/client/src/App.jsx
+++ b/web/client/src/App.jsx
@@ -7,6 +7,10 @@ import Categories from "./pages/Categories";
 import About from "./pages/About";
 import Recommend from "./pages/Recommend";
 
+/**
+ * Main application router.
+ * Renders layout with Navbar/Footer and routes to pages.
+ */
 export default function App() {
   return (
     <>
diff --git a/web/client/src/components/Navbar.jsx b/web/client/src/components/Navbar.jsx
index 19d0338..c14d374 100644
--- a/web/client/src/components/Navbar.jsx
+++ b/web/client/src/components/Navbar.jsx
@@ -9,6 +9,9 @@ const NAV_LINKS = [
   { label: "About", to: "/about" },
 ];
 
+/**
+ * Site navigation bar with responsive menu.
+ */
 export default function Navbar() {
   const [open, setOpen] = useState(false);
   const { pathname } = useLocation();
diff --git a/web/client/src/hooks/useDebounce.js b/web/client/src/hooks/useDebounce.js
index 34ee605..da5b65a 100644
--- a/web/client/src/hooks/useDebounce.js
+++ b/web/client/src/hooks/useDebounce.js
@@ -1,5 +1,11 @@
 import { useState, useEffect } from "react";
 
+/**
+ * Debounces a value to delay updates (e.g., for search input).
+ * @param {any} value - The value to debounce.
+ * @param {number} delay - Delay in ms (default 300).
+ * @returns {any} The debounced value.
+ */
 export function useDebounce(value, delay = 300) {
   const [debounced, setDebounced] = useState(value);
   useEffect(() => {