docs/project-structure.md

Project Structure

Directory Layout

• client/: Frontend React application
  • components/: Feature-based UI components
    • App/: Main application component with error boundaries
    • AiResponse/: AI response display and chat interface components
    • Analytics/: Search analytics and statistics components
    • Logs/: Application logging and debug components
    • Pages/: Route-level page components
      • Main/: Main search interface with menu and settings
    • Search/: Search functionality components
      • Form/: Search input and form components
      • History/: Search history and saved searches
      • Results/: Search results display (textual and graphical)
    • Settings/: Application settings and configuration
  • modules/: Core business logic (PubSub stores, search services, database layers)
  • hooks/: Custom React hooks
  • public/: Static assets
• server/: Server hooks for search endpoints, caching, compression, CORS, and API validation
• shared/: Utilities shared between client and server
• vite.config.ts: Build and server configuration with environment-driven feature flags

Component Organization

Components are organized by feature domain. Each component folder contains:

• Component implementation
• Related styles
• Custom hooks
• Utility functions
• Tests

This self-contained structure makes it easy for agents to understand and modify components without navigating across the codebase.

Related Topics

• Overview: docs/overview.md - System architecture and data flow
• UI Components: docs/ui-components.md - Component architecture and PubSub patterns
• Quick Start: docs/quick-start.md - Installation and setup