From 01fb74af254d29c5f58ee10e352c7e2bb13b23dc Mon Sep 17 00:00:00 2001
From: Oliver <oliver.henry.walters@gmail.com>
Date: Fri, 19 Jun 2026 15:33:12 +1000
Subject: [PATCH] [UI] Tree improvements (#12204)

* Hide expand icon for items without children

* Add searching to CategoryTree API

* Add "level" filter

* Automatically include parent tree when searching

* Include tree_id field

* Add search input to NavigationTree

* Add more API filters

* Load child nodes iteratively

* Fix dynamic loading of nodes

* Highlight selected item

* Include pathstring

* Fix insertion order

* Auto-expand to the selected ID

* Add "no results" message

* Refactor into generic components

* Expand to multi level

* Use async node loading functionality

* Add hovercard

* Implement same functionality for StockLocationTree API endpoint

* Adjust spacing

* Add connecting lines

* Add playwright test

* Bump API version

* Add CHANGELOG entry

* Update docs

* Update screenshot
---
 CHANGELOG.md                                  |   1 +
 .../images/concepts/ui_navigation_tree.png    | Bin 25041 -> 41520 bytes
 docs/docs/concepts/user_interface.md          |  12 +
 src/backend/InvenTree/InvenTree/api.py        |  41 +++
 .../InvenTree/InvenTree/api_version.py        |   5 +-
 src/backend/InvenTree/part/api.py             |  38 ++-
 src/backend/InvenTree/part/serializers.py     |  15 +-
 src/backend/InvenTree/stock/api.py            |  35 +-
 src/backend/InvenTree/stock/serializers.py    |  13 +-
 .../src/components/nav/NavigationTree.tsx     | 315 ++++++++++++++----
 .../src/pages/part/CategoryDetail.tsx         |   1 +
 src/frontend/src/pages/part/PartDetail.tsx    |   1 +
 .../src/pages/stock/LocationDetail.tsx        |   1 +
 src/frontend/src/pages/stock/StockDetail.tsx  |   1 +
 src/frontend/tests/pages/pui_stock.spec.ts    |  18 +
 15 files changed, 411 insertions(+), 86 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4c441b199c..10a4265b85 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -16,6 +16,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- [#12204](https://github.com/inventree/InvenTree/pull/12204) adds new filtering options to PartCategoryTree and StockLocationTree API endpoints, allowing tree data to be fetched dynamically
 - [#12165](https://github.com/inventree/InvenTree/pull/12165) adds support for parameters against the PartCategory model
 - [#12103](https://github.com/inventree/InvenTree/pull/12103) adds column-based filtering to table views in the user interface. This extends the existing table filtering functionality by allowing users to apply filters directly to individual columns.
 - [#12093](https://github.com/inventree/InvenTree/pull/12093) adds "read_only" attribute to PluginSetting API endpoint, which indicates whether a particular plugin setting is read-only (i.e. cannot be modified via the API)
diff --git a/docs/docs/assets/images/concepts/ui_navigation_tree.png b/docs/docs/assets/images/concepts/ui_navigation_tree.png
index 5d274452ab8141e4bac90050a0e3631cc067519f..e124cd51bfa729103ee9ae47db7ca374c39ef765 100644
GIT binary patch
literal 41520
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
OZ(%-5jqi@jx&1eqP!yd2

literal 25041
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
IHvcpK1f>zbrT_o{

diff --git a/docs/docs/concepts/user_interface.md b/docs/docs/concepts/user_interface.md
index c9973c514c..80f9f231c2 100644
--- a/docs/docs/concepts/user_interface.md
+++ b/docs/docs/concepts/user_interface.md
@@ -91,6 +91,18 @@ Click on the navigation tree icon to expand the tree and view the available navi
 
 {{ image("concepts/ui_navigation_tree.png", "Navigation Tree") }}
 
+#### Searching
+
+The navigation tree includes a search bar at the top of the panel. Typing into the search bar filters the tree to show only entries that match the search query. When a search is active, all matching results are expanded and displayed in a flat list. Clearing the search field returns the tree to its normal browsing mode.
+
+#### Highlight Selected Entry
+
+The currently selected entry in the navigation tree is highlighted with a distinct background color, making it easy to identify the active page or section within the hierarchy.
+
+#### Auto-Expand to Selected Entry
+
+When the navigation tree is opened, it automatically expands to reveal the currently selected entry. All ancestor nodes in the hierarchy are expanded so the active entry is immediately visible, without requiring manual navigation through the tree.
+
 ## Dashboard
 
 The dashboard provides a customizable landing page for users when they log in to the system. The dashboard can be configured to display a variety of widgets and information panels, providing users with quick access to important data and actions.
diff --git a/src/backend/InvenTree/InvenTree/api.py b/src/backend/InvenTree/InvenTree/api.py
index 79b080bb1d..a85498596f 100644
--- a/src/backend/InvenTree/InvenTree/api.py
+++ b/src/backend/InvenTree/InvenTree/api.py
@@ -23,6 +23,7 @@ from rest_framework.serializers import ValidationError
 from rest_framework.views import APIView
 
 import InvenTree.config
+import InvenTree.filters
 import InvenTree.permissions
 import InvenTree.version
 from common.settings import get_global_setting
@@ -963,3 +964,43 @@ def meta_path(model, lookup_field: str = 'pk', lookup_field_ref: str = 'pk'):
             lookup_field_ref=lookup_field_ref,
         ),
     )
+
+
+class TreeMixin:
+    """A mixin class for supporting tree-structured data in the API."""
+
+    # Any API view which inherits from this mixin must define a 'model_class' attribute
+    model_class = None
+
+    filter_backends = InvenTree.filters.SEARCH_ORDER_FILTER
+    search_fields = ['name', 'description']
+    ordering_fields = ['level', 'name', 'subcategories']
+    ordering_field_aliases = {'level': ['level', 'name'], 'name': ['name', 'level']}
+    ordering = ['level']
+
+    def filter_queryset(self, queryset):
+        """Filter the queryset, and provide extra support for tree-structured data."""
+        queryset = super().filter_queryset(queryset)
+
+        # If a search term is provided, include all ancestors of matched items in the results
+        if self.request.query_params.get('search', '').strip():
+            ancestors = self.model_class.objects.get_queryset_ancestors(
+                queryset, include_self=True
+            )
+            queryset = queryset | ancestors
+
+        # If a specific ID is provided to "expand_to", include all ancestors and siblings
+        if expand_to := self.request.query_params.get('expand_to'):
+            try:
+                target = self.model_class.objects.get(pk=int(expand_to))
+                target_ancestors = target.get_ancestors(include_self=True)
+                queryset = queryset | target_ancestors
+
+                # We also want to include the "sibling" nodes of the expanded item
+                siblings = target.get_siblings(include_self=True)
+                queryset = queryset | siblings
+
+            except (self.model_class.DoesNotExist, ValueError):
+                pass
+
+        return queryset.distinct()
diff --git a/src/backend/InvenTree/InvenTree/api_version.py b/src/backend/InvenTree/InvenTree/api_version.py
index fff7f52f77..14341d04fb 100644
--- a/src/backend/InvenTree/InvenTree/api_version.py
+++ b/src/backend/InvenTree/InvenTree/api_version.py
@@ -1,11 +1,14 @@
 """InvenTree API version information."""
 
 # InvenTree API version
-INVENTREE_API_VERSION = 510
+INVENTREE_API_VERSION = 511
 """Increment this API version number whenever there is a significant change to the API that any clients need to know about."""
 
 INVENTREE_API_TEXT = """
 
+v511 -> 2026-06-19 : https://github.com/inventree/InvenTree/pull/12204
+    - Adds new filtering options to PartCategoryTree and StockLocationTree API endpoints
+
 v510 -> 2026-06-18 : https://github.com/inventree/InvenTree/pull/12197
     - Require "staff" access permissions for the machine restart API endpoint
 
diff --git a/src/backend/InvenTree/part/api.py b/src/backend/InvenTree/part/api.py
index 0df77ff826..1eb603dd7c 100644
--- a/src/backend/InvenTree/part/api.py
+++ b/src/backend/InvenTree/part/api.py
@@ -21,6 +21,7 @@ from InvenTree.api import (
     BulkUpdateMixin,
     ListCreateDestroyAPIView,
     ParameterListMixin,
+    TreeMixin,
     meta_path,
 )
 from InvenTree.fields import InvenTreeOutputOption, OutputConfiguration
@@ -284,25 +285,38 @@ class CategoryDetail(CategoryMixin, OutputOptionsMixin, CustomRetrieveUpdateDest
         )
 
 
-class CategoryTree(ListAPI):
+class CategoryTreeFilter(FilterSet):
+    """Custom filterset class for the CategoryTree endpoint."""
+
+    class Meta:
+        """Metaclass options for this filterset."""
+
+        model = PartCategory
+        fields = ['parent', 'tree_id', 'level']
+
+    max_level = rest_filters.NumberFilter(
+        label=_('Max Level'),
+        method='filter_max_level',
+        help_text=_('Limit the depth of the category tree'),
+    )
+
+    def filter_max_level(self, queryset, name, value):
+        """Filter by the maximum depth of the category tree."""
+        return queryset.filter(level__lte=value)
+
+
+class CategoryTree(TreeMixin, ListAPI):
     """API endpoint for accessing a list of PartCategory objects ready for rendering a tree."""
 
+    model_class = PartCategory
     queryset = PartCategory.objects.all()
-    serializer_class = part_serializers.CategoryTree
-
-    filter_backends = ORDER_FILTER
-
-    ordering_fields = ['level', 'name', 'subcategories']
-
-    ordering_field_aliases = {'level': ['level', 'name'], 'name': ['name', 'level']}
-
-    # Order by tree level (top levels first) and then name
-    ordering = ['level', 'name']
+    serializer_class = part_serializers.CategoryTreeSerializer
+    filterset_class = CategoryTreeFilter
 
     def get_queryset(self, *args, **kwargs):
         """Return an annotated queryset for the CategoryTree endpoint."""
         queryset = super().get_queryset(*args, **kwargs)
-        queryset = part_serializers.CategoryTree.annotate_queryset(queryset)
+        queryset = part_serializers.CategoryTreeSerializer.annotate_queryset(queryset)
         return queryset
 
 
diff --git a/src/backend/InvenTree/part/serializers.py b/src/backend/InvenTree/part/serializers.py
index d0ce0d43fa..a9a87c7e80 100644
--- a/src/backend/InvenTree/part/serializers.py
+++ b/src/backend/InvenTree/part/serializers.py
@@ -181,14 +181,25 @@ class CategorySerializer(
     parameters = common.filters.enable_parameters_filter()
 
 
-class CategoryTree(InvenTree.serializers.InvenTreeModelSerializer):
+class CategoryTreeSerializer(InvenTree.serializers.InvenTreeModelSerializer):
     """Serializer for PartCategory tree."""
 
     class Meta:
         """Metaclass defining serializer fields."""
 
         model = PartCategory
-        fields = ['pk', 'name', 'parent', 'icon', 'structural', 'subcategories']
+        fields = [
+            'pk',
+            'name',
+            'description',
+            'pathstring',
+            'parent',
+            'tree_id',
+            'level',
+            'icon',
+            'structural',
+            'subcategories',
+        ]
 
     subcategories = serializers.IntegerField(label=_('Subcategories'), read_only=True)
 
diff --git a/src/backend/InvenTree/stock/api.py b/src/backend/InvenTree/stock/api.py
index 448477782d..31ef0f915a 100644
--- a/src/backend/InvenTree/stock/api.py
+++ b/src/backend/InvenTree/stock/api.py
@@ -33,11 +33,11 @@ from InvenTree.api import (
     BulkCreateMixin,
     BulkUpdateMixin,
     ListCreateDestroyAPIView,
+    TreeMixin,
     meta_path,
 )
 from InvenTree.fields import InvenTreeOutputOption, OutputConfiguration
 from InvenTree.filters import (
-    ORDER_FILTER,
     SEARCH_ORDER_FILTER,
     InvenTreeDateFilter,
     NumberOrNullFilter,
@@ -455,20 +455,33 @@ class StockLocationDetail(
         )
 
 
-class StockLocationTree(ListAPI):
+class LocationTreeFilter(FilterSet):
+    """Custom filterset class for the StockLocationTree endpoint."""
+
+    class Meta:
+        """Metaclass options for this filterset."""
+
+        model = StockLocation
+        fields = ['parent', 'tree_id', 'level']
+
+    max_level = rest_filters.NumberFilter(
+        label=_('Max Level'),
+        method='filter_max_level',
+        help_text=_('Limit the depth of the category tree'),
+    )
+
+    def filter_max_level(self, queryset, name, value):
+        """Filter by the maximum depth of the category tree."""
+        return queryset.filter(level__lte=value)
+
+
+class StockLocationTree(TreeMixin, ListAPI):
     """API endpoint for accessing a list of StockLocation objects, ready for rendering as a tree."""
 
+    model_class = StockLocation
     queryset = StockLocation.objects.all()
     serializer_class = StockSerializers.LocationTreeSerializer
-
-    filter_backends = ORDER_FILTER
-
-    ordering_fields = ['level', 'name', 'sublocations']
-
-    # Order by tree level (top levels first) and then name
-    ordering = ['level', 'name']
-
-    ordering_field_aliases = {'level': ['level', 'name'], 'name': ['name', 'level']}
+    filterset_class = LocationTreeFilter
 
     def get_queryset(self, *args, **kwargs):
         """Return annotated queryset for the StockLocationTree endpoint."""
diff --git a/src/backend/InvenTree/stock/serializers.py b/src/backend/InvenTree/stock/serializers.py
index 4943dd6dfe..90b1770e62 100644
--- a/src/backend/InvenTree/stock/serializers.py
+++ b/src/backend/InvenTree/stock/serializers.py
@@ -1160,7 +1160,18 @@ class LocationTreeSerializer(InvenTree.serializers.InvenTreeModelSerializer):
         """Metaclass options."""
 
         model = StockLocation
-        fields = ['pk', 'name', 'parent', 'icon', 'structural', 'sublocations']
+        fields = [
+            'pk',
+            'name',
+            'description',
+            'pathstring',
+            'parent',
+            'tree_id',
+            'level',
+            'icon',
+            'structural',
+            'sublocations',
+        ]
 
     sublocations = serializers.IntegerField(label=_('Sublocations'), read_only=True)
 
diff --git a/src/frontend/src/components/nav/NavigationTree.tsx b/src/frontend/src/components/nav/NavigationTree.tsx
index edca9924c5..ac214707d0 100644
--- a/src/frontend/src/components/nav/NavigationTree.tsx
+++ b/src/frontend/src/components/nav/NavigationTree.tsx
@@ -5,28 +5,36 @@ import {
   Divider,
   Drawer,
   Group,
+  HoverCard,
+  Loader,
   LoadingOverlay,
   type RenderTreeNodePayload,
   Space,
   Stack,
+  Text,
+  TextInput,
   Tree,
   type TreeNodeData,
   useTree
 } from '@mantine/core';
+import { useDebouncedValue } from '@mantine/hooks';
 import {
   IconChevronDown,
   IconChevronRight,
   IconExclamationCircle,
-  IconSitemap
+  IconSearch,
+  IconSitemap,
+  IconX
 } from '@tabler/icons-react';
 import { useQuery } from '@tanstack/react-query';
-import { useCallback, useMemo } from 'react';
+import { useCallback, useEffect, useMemo, useState } from 'react';
 import { useNavigate } from 'react-router-dom';
 
 import { StylishText } from '@lib/components/StylishText';
 import type { ApiEndpoints } from '@lib/enums/ApiEndpoints';
 import type { ModelType } from '@lib/enums/ModelType';
 import { apiUrl } from '@lib/functions/Api';
+import { resolveItem } from '@lib/functions/Conversion';
 import {
   eventModified,
   getDetailUrl,
@@ -45,6 +53,7 @@ export default function NavigationTree({
   onClose,
   selectedId,
   modelType,
+  childIdentifier,
   endpoint
 }: Readonly<{
   title: string;
@@ -52,26 +61,136 @@ export default function NavigationTree({
   onClose: () => void;
   selectedId?: number | null;
   modelType: ModelType;
+  childIdentifier?: string;
   endpoint: ApiEndpoints;
 }>) {
   const api = useApi();
   const navigate = useNavigate();
   const treeState = useTree();
 
-  // Data query to fetch the tree data from server
+  const [searchValue, setSearchValue] = useState('');
+  const [debouncedSearch] = useDebouncedValue(searchValue, 300);
+
+  // Accumulated flat node list for browse (lazy-load) mode
+  const [allNodes, setAllNodes] = useState<any[]>([]);
+  // PKs of nodes whose children are currently being fetched
+  const [loadingNodes, setLoadingNodes] = useState<Set<number>>(new Set());
+
+  // Reset everything when the drawer opens or closes
+  useEffect(() => {
+    setSearchValue('');
+    setAllNodes([]);
+    setLoadingNodes(new Set());
+  }, [opened]);
+
+  // Data query — browse mode loads root nodes only; search mode loads all matches + ancestors
   const query = useQuery({
     enabled: opened,
-    queryKey: [modelType, opened],
+    queryKey: [modelType, 'tree', opened, debouncedSearch, selectedId],
     queryFn: async () =>
       api
         .get(apiUrl(endpoint), {
-          data: {
-            ordering: 'level'
+          params: {
+            ordering: 'level',
+            search: debouncedSearch || undefined,
+            max_level: debouncedSearch ? undefined : 0,
+            expand_to: debouncedSearch ? undefined : (selectedId ?? undefined)
           }
         })
         .then((response) => response.data ?? [])
   });
 
+  // When the browse-mode query settles, reset the node list and expand ancestors of the selection
+  useEffect(() => {
+    if (!debouncedSearch && query.data && !query.isFetching) {
+      setAllNodes(query.data);
+      setLoadingNodes(new Set());
+
+      if (selectedId) {
+        const nodeMap: Record<number, any> = {};
+        for (const n of query.data) nodeMap[n.pk] = n;
+
+        // Collect every ancestor pk, then apply in one setExpandedState call to
+        // avoid closure/batching issues that arise from calling expand() in a loop.
+        const toExpand: Record<string, boolean> = {};
+        let current = nodeMap[selectedId];
+        while (current?.parent) {
+          toExpand[current.parent.toString()] = true;
+          current = nodeMap[current.parent];
+        }
+        if (Object.keys(toExpand).length) {
+          treeState.setExpandedState({
+            ...treeState.expandedState,
+            ...toExpand
+          });
+        }
+      }
+    }
+  }, [debouncedSearch, query.data, query.isFetching, selectedId]);
+
+  // Collapse all nodes when the search term changes (switching modes).
+  // Intentionally omits query.data so it does NOT fire when browse results arrive —
+  // that would undo the ancestor expansion done above.
+  useEffect(() => {
+    treeState.collapseAllNodes();
+  }, [debouncedSearch]);
+
+  // Expand all nodes once search results have fully arrived
+  useEffect(() => {
+    if (debouncedSearch && !query.isFetching && query.data?.length) {
+      treeState.expandAllNodes();
+    }
+  }, [debouncedSearch, query.data, query.isFetching]);
+
+  // Fetch direct children of a node (browse mode only).
+  // Zeros out the childIdentifier count on success with no results so the node
+  // is treated as a leaf and won't be re-fetched on subsequent clicks.
+  const fetchChildren = useCallback(
+    async (nodeValue: string) => {
+      const pk = Number.parseInt(nodeValue);
+      if (loadingNodes.has(pk)) return;
+
+      const nodeInfo = allNodes.find((n) => n.pk === pk);
+      if (!nodeInfo) return;
+
+      setLoadingNodes((prev) => new Set([...prev, pk]));
+
+      try {
+        const response = await api.get(apiUrl(endpoint), {
+          params: {
+            ordering: 'level',
+            parent: pk,
+            max_level: nodeInfo.level + 1
+          }
+        });
+        const children: any[] = response.data ?? [];
+
+        setAllNodes((prev) => {
+          if (children.length === 0 && childIdentifier) {
+            // No children returned — zero out the count so this node is treated
+            // as a leaf and won't trigger another fetch on the next click.
+            return prev.map((n) =>
+              n.pk === pk ? { ...n, [childIdentifier]: 0 } : n
+            );
+          }
+          const existing = new Set(prev.map((n) => n.pk));
+          return [...prev, ...children.filter((n) => !existing.has(n.pk))];
+        });
+
+        if (children.length > 0) {
+          treeState.expand(nodeValue);
+        }
+      } finally {
+        setLoadingNodes((prev) => {
+          const next = new Set(prev);
+          next.delete(pk);
+          return next;
+        });
+      }
+    },
+    [loadingNodes, allNodes, api, endpoint, childIdentifier]
+  );
+
   const follow = useCallback(
     (node: TreeNodeData, event?: any) => {
       const url = getDetailUrl(modelType, node.value);
@@ -85,107 +204,156 @@ export default function NavigationTree({
     [modelType, navigate]
   );
 
-  // Map returned query to a "tree" structure
-  const data: TreeNodeData[] = useMemo(() => {
-    /*
-     * Reconstruct the navigation tree from the provided data.
-     * It is required (and assumed) that the data is first sorted by level.
-     */
+  // In search mode use the query results directly; in browse mode use the accumulated lazy-load list
+  const sourceNodes: any[] = useMemo(
+    () => (debouncedSearch ? (query.data ?? []) : allNodes),
+    [debouncedSearch, query.data, allNodes]
+  );
 
+  // Map flat node list to a nested tree structure (parents must precede children)
+  const data: TreeNodeData[] = useMemo(() => {
     const nodes: Record<number, any> = {};
     const tree: TreeNodeData[] = [];
 
-    if (!query || !query?.data?.length) {
-      return [];
-    }
+    if (!sourceNodes.length) return [];
 
-    for (let ii = 0; ii < query.data.length; ii++) {
+    // Sort by level so parents are always inserted before their children,
+    // regardless of the order the API returns items (e.g. after ancestor union in search mode).
+    const sorted = [...sourceNodes].sort((a, b) => a.level - b.level);
+
+    for (const raw of sorted) {
       const node = {
-        ...query.data[ii],
+        ...raw,
         children: [],
         label: (
           <Group gap='xs'>
-            <ApiIcon name={query.data[ii].icon} />
-            {query.data[ii].name}
+            <ApiIcon name={raw.icon} />
+            <Text>{raw.name}</Text>
           </Group>
         ),
-        value: query.data[ii].pk.toString(),
-        selected: query.data[ii].pk === selectedId
+        value: raw.pk.toString(),
+        selected: raw.pk === selectedId
       };
 
       const pk: number = node.pk;
       const parent: number | null = node.parent;
 
       if (!parent) {
-        // This is a top level node
         tree.push(node);
       } else {
-        // This is *not* a top level node, so the parent *must* already exist
         nodes[parent]?.children.push(node);
       }
 
-      // Finally, add this node
       nodes[pk] = node;
-
-      if (pk === selectedId) {
-        // Expand all parents
-        let parent = nodes[node.parent];
-        while (parent) {
-          parent.expanded = true;
-          parent = nodes[parent.parent];
-        }
-      }
     }
 
     return tree;
-  }, [selectedId, query.data]);
+  }, [selectedId, sourceNodes]);
 
   const renderNode = useCallback(
     (payload: RenderTreeNodePayload) => {
+      const nodeInfo = payload.node as any;
+      const pk = Number.parseInt(payload.node.value);
+      const isLoading = loadingNodes.has(pk);
+
+      // A node has children if they are already in the tree, or if the server-side
+      // count (childIdentifier) says so and they haven't been loaded yet.
+      const childrenLoaded = nodeInfo.children.length > 0;
+      const needsFetch =
+        !isLoading &&
+        !debouncedSearch &&
+        !childrenLoaded &&
+        !!(childIdentifier && resolveItem(payload.node, childIdentifier));
+      const hasChildren = childrenLoaded || needsFetch;
+
+      const isSelected = nodeInfo.selected === true;
+
       return (
         <Group
           p={3}
-          gap='xs'
+          gap={5}
           justify='left'
           key={payload.node.value}
           wrap='nowrap'
+          bg={isSelected ? 'var(--mantine-primary-color-light)' : undefined}
+          style={{ borderRadius: 'var(--mantine-radius-sm)' }}
           onClick={() => {
-            if (payload.hasChildren) {
+            if (isLoading || !hasChildren) return;
+            if (needsFetch) {
+              fetchChildren(payload.node.value);
+            } else {
               treeState.toggleExpanded(payload.node.value);
             }
           }}
         >
-          <Space w={10 * (payload.level - 1)} />
-          <ActionIcon
-            size='sm'
-            variant='transparent'
-            aria-label={`nav-tree-toggle-${payload.node.value}}`}
+          <Space w={25 * (payload.level - 1)} />
+          {(isLoading || hasChildren || payload.expanded) && (
+            <ActionIcon
+              size='sm'
+              variant='transparent'
+              aria-label={`nav-tree-toggle-${payload.node.value}}`}
+            >
+              {isLoading ? (
+                <Loader size='xs' />
+              ) : hasChildren ? (
+                payload.expanded ? (
+                  <IconChevronDown />
+                ) : (
+                  <IconChevronRight />
+                )
+              ) : null}
+            </ActionIcon>
+          )}
+          <HoverCard
+            width={260}
+            shadow='md'
+            withArrow
+            closeDelay={100}
+            openDelay={500}
+            position='top-end'
           >
-            {payload.hasChildren ? (
-              payload.expanded ? (
-                <IconChevronDown />
-              ) : (
-                <IconChevronRight />
-              )
-            ) : null}
-          </ActionIcon>
-          <Anchor
-            onClick={(event: any) => follow(payload.node, event)}
-            aria-label={`nav-tree-item-${payload.node.value}`}
-            c='var(--mantine-color-text)'
-          >
-            {payload.node.label}
-          </Anchor>
+            <HoverCard.Target>
+              <Anchor
+                onClick={(event: any) => follow(payload.node, event)}
+                aria-label={`nav-tree-item-${payload.node.value}`}
+                c='var(--mantine-color-text)'
+              >
+                {payload.node.label}
+              </Anchor>
+            </HoverCard.Target>
+            <HoverCard.Dropdown>
+              <Stack gap={4}>
+                <Group gap='xs' wrap='nowrap'>
+                  {nodeInfo.icon && <ApiIcon name={nodeInfo.icon} />}
+                  <Text fw={600} size='sm'>
+                    {nodeInfo.name}
+                  </Text>
+                </Group>
+                {nodeInfo.description && (
+                  <Text size='sm' c='dimmed'>
+                    {nodeInfo.description}
+                  </Text>
+                )}
+              </Stack>
+            </HoverCard.Dropdown>
+          </HoverCard>
         </Group>
       );
     },
-    [treeState]
+    [
+      treeState,
+      childIdentifier,
+      follow,
+      loadingNodes,
+      fetchChildren,
+      debouncedSearch
+    ]
   );
 
   return (
     <Drawer
       opened={opened}
-      size='md'
+      size='lg'
       position='left'
       onClose={onClose}
       withCloseButton={true}
@@ -205,14 +373,43 @@ export default function NavigationTree({
       }
     >
       <Stack gap='xs'>
+        <TextInput
+          aria-label='nav-tree-search'
+          placeholder={t`Search...`}
+          value={searchValue}
+          onChange={(event) => setSearchValue(event.currentTarget.value)}
+          leftSection={<IconSearch size={16} />}
+          rightSection={
+            searchValue ? (
+              <ActionIcon
+                size='sm'
+                variant='transparent'
+                onClick={() => setSearchValue('')}
+                aria-label={t`Clear search`}
+              >
+                <IconX size={14} />
+              </ActionIcon>
+            ) : null
+          }
+        />
         <Divider />
         <LoadingOverlay visible={query.isFetching || query.isLoading} />
         {query.isError ? (
           <Alert color='red' title={t`Error`} icon={<IconExclamationCircle />}>
             {t`Error loading navigation tree.`}
           </Alert>
+        ) : !query.isFetching && !query.isLoading && data.length === 0 ? (
+          <Alert color='blue' icon={<IconSearch />}>
+            {t`No results found`}
+          </Alert>
         ) : (
-          <Tree data={data} tree={treeState} renderNode={renderNode} />
+          <Tree
+            data={data}
+            tree={treeState}
+            renderNode={renderNode}
+            withLines
+            levelOffset={25}
+          />
         )}
       </Stack>
     </Drawer>
diff --git a/src/frontend/src/pages/part/CategoryDetail.tsx b/src/frontend/src/pages/part/CategoryDetail.tsx
index 4c47958da5..9d0077e9c8 100644
--- a/src/frontend/src/pages/part/CategoryDetail.tsx
+++ b/src/frontend/src/pages/part/CategoryDetail.tsx
@@ -377,6 +377,7 @@ export default function CategoryDetail() {
             modelType={ModelType.partcategory}
             title={t`Part Categories`}
             endpoint={ApiEndpoints.category_tree}
+            childIdentifier='subcategories'
             opened={treeOpen}
             onClose={() => {
               setTreeOpen(false);
diff --git a/src/frontend/src/pages/part/PartDetail.tsx b/src/frontend/src/pages/part/PartDetail.tsx
index 5182a1c249..af83e85522 100644
--- a/src/frontend/src/pages/part/PartDetail.tsx
+++ b/src/frontend/src/pages/part/PartDetail.tsx
@@ -1152,6 +1152,7 @@ export default function PartDetail() {
           {user.hasViewRole(UserRoles.part_category) && (
             <NavigationTree
               title={t`Part Categories`}
+              childIdentifier='subcategories'
               modelType={ModelType.partcategory}
               endpoint={ApiEndpoints.category_tree}
               opened={treeOpen}
diff --git a/src/frontend/src/pages/stock/LocationDetail.tsx b/src/frontend/src/pages/stock/LocationDetail.tsx
index 5fbab60d46..0b13ba9f23 100644
--- a/src/frontend/src/pages/stock/LocationDetail.tsx
+++ b/src/frontend/src/pages/stock/LocationDetail.tsx
@@ -514,6 +514,7 @@ export default function Stock() {
             title={t`Stock Locations`}
             modelType={ModelType.stocklocation}
             endpoint={ApiEndpoints.stock_location_tree}
+            childIdentifier='sublocations'
             opened={treeOpen}
             onClose={() => setTreeOpen(false)}
             selectedId={location?.pk}
diff --git a/src/frontend/src/pages/stock/StockDetail.tsx b/src/frontend/src/pages/stock/StockDetail.tsx
index 451b787afa..5d73866074 100644
--- a/src/frontend/src/pages/stock/StockDetail.tsx
+++ b/src/frontend/src/pages/stock/StockDetail.tsx
@@ -1066,6 +1066,7 @@ export default function StockDetail() {
               title={t`Stock Locations`}
               modelType={ModelType.stocklocation}
               endpoint={ApiEndpoints.stock_location_tree}
+              childIdentifier='sublocations'
               opened={treeOpen}
               onClose={() => setTreeOpen(false)}
               selectedId={stockitem?.location}
diff --git a/src/frontend/tests/pages/pui_stock.spec.ts b/src/frontend/tests/pages/pui_stock.spec.ts
index 0f568349f1..bcf8d64d72 100644
--- a/src/frontend/tests/pages/pui_stock.spec.ts
+++ b/src/frontend/tests/pages/pui_stock.spec.ts
@@ -70,6 +70,24 @@ test('Stock - Location Tree', async ({ browser }) => {
   await page.getByLabel('breadcrumb-1-factory').click();
 
   await page.getByRole('cell', { name: 'Factory' }).first().waitFor();
+
+  // Load the tree again - from a deeply nested location
+  // We expect it to auto-expand to the current location
+  await navigate(page, 'stock/location/17/stock-items');
+  await page.getByLabel('nav-breadcrumb-action').click();
+
+  for (let ii = 0; ii <= 5; ii++) {
+    await page
+      .locator('div')
+      .filter({ hasText: `Location ${ii}` })
+      .first()
+      .waitFor();
+  }
+
+  // Let's search for a particular location
+  await page.getByRole('textbox', { name: 'nav-tree-search' }).fill('room');
+  await page.getByText('Storage Room A').first().waitFor();
+  await page.getByText('Storage Room B').first().waitFor();
 });
 
 test('Stock - Location Delete', async ({ browser }) => {