🔍 Global Search Documentation

Overview

The GoGrab Space documentation system features a powerful global search functionality that allows users to quickly find content across all documentation projects. The search is optimized for performance and provides intelligent filtering and organization.

Features

🚀 Core Search Capabilities

• Real-time Search: Instant search results as you type
• Multi-project Search: Search across all documentation projects simultaneously
• Smart Filtering: Filter results by specific projects
• Infinite Scroll: Load more results seamlessly for large result sets
• Keyboard Navigation: Full keyboard support for power users

🎯 Project-based Organization

• Project Tags: Visual project indicators with color coding
• Result Counts: See how many results each project contains
• Drag & Drop: Reorder project tags by dragging them
• Smart Sorting: Tags automatically sort by result count

🎨 Visual Enhancements

• Color-coded Results: Each project has a unique color for easy identification
• Project Badges: Visual indicators showing which project each result belongs to
• Modern UI: Clean, responsive design with smooth animations

Usage

Opening Search

• Keyboard Shortcut: Cmd + K (Mac) or Ctrl + K (Windows/Linux)
• Click: Use the search icon in the header

Searching

1. Type your query in the search input
2. Results appear instantly as you type
3. Use arrow keys to navigate through results
4. Press Enter to select a result
5. Press Escape to close the search

Filtering by Project

1. Click project tags at the bottom of the search modal
2. Multiple selection: Click multiple tags to search across several projects
3. Toggle off: Click a selected tag to deselect it
4. All projects: Click "All" to search across all projects
5. Current project: Click "Current" to search only the current project

Advanced Features

Drag & Drop Reordering

• Drag project tags to reorder them
• Custom order is maintained across sessions
• Visual feedback during dragging

Infinite Scroll

• Scroll down in results to load more
• Automatic loading when you reach the bottom
• Performance optimized for large result sets

Keyboard Shortcuts

• ↑ / ↓ - Navigate through results
• Enter - Select current result
• Escape - Close search modal
• Cmd/Ctrl + K - Open search modal

Technical Implementation

Architecture

The search system is built with Angular 20 and uses:

• Signals: For reactive state management
• RxJS: For search stream processing and debouncing
• Indexed Search: Pre-built search index for fast results
• Project Detection: Automatic project identification from file paths

Performance Optimizations

• Debounced Search: 150ms debounce for responsive feel
• Lazy Loading: Results loaded on demand
• Efficient Indexing: Pre-built search index with content extraction
• Smart Caching: Manifest cache for fast initialization

Search Index

The search index includes:

• File Content: Full text content of documentation files
• Headings: All markdown headings for better navigation
• Metadata: Project information, language, and visibility
• Relevance Scoring: Intelligent scoring based on title and content matches

Configuration

Project Colors

Each project has a predefined color scheme:

• Public: Blue (#3b82f6)
• GoGrab-Space: Emerald (#10b981)
• GoGrab-Pulse: Amber (#f59e0b)
• GoGrab-Space-Deck-md: Violet (#8b5cf6)
• docs-to-review: Red (#ef4444)
• Private: Gray (#6b7280)

Search Limits

• Initial Results: 10 results per search (optimized for performance)
• Load More: Additional 10 results per load
• Maximum: No hard limit (infinite scroll)

Troubleshooting

Common Issues

Search not working?

• Refresh the page to reinitialize the search index
• Check console for any error messages
• Ensure you have proper access permissions

Slow search performance?

• The search is optimized for performance
• Large result sets may take a moment to load
• Use project filtering to narrow down results

Missing results?

• Check if the content is in the correct project
• Verify file permissions and visibility settings
• Ensure the file is properly indexed

Debug Information

The search system provides debug information in the browser console:

• Search index initialization status
• Project detection results
• Search performance metrics

Future Enhancements

Planned improvements include:

• Search History: Remember recent searches
• Saved Searches: Save frequently used search queries
• Advanced Filters: Filter by file type, date, author
• Search Analytics: Track search usage patterns
• AI-powered Suggestions: Smart search suggestions

Search powered by GoGrab Space 🚀