home/hey-search
2
0
Fork 0
mirror of https://github.com/wahyd4/hey-search.git synced 2026-08-08 21:05:14 +10:00
Code Issues Packages Projects Releases Wiki Activity
Files
bd22089d2323743b22eb6179e7ac46b409b65d86
hey-search/FEATURES.md
T
junvandCopilot bd22089d23 Update CHANGELOG and FEATURES docs for v1.3.0 
- Lightbox navigation with arrow keys
- Visited link styling
- Mobile settings modal fix
- Search stats collapsed by default on mobile

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-02-23 16:28:04 +11:00

3.1 KiB
Raw Blame History

Features

Search

  • Web search — aggregates results from Brave, DuckDuckGo, Google, and Bing concurrently
  • Image search — Pinterest-style masonry layout respecting natural image aspect ratios, with lightbox viewer and keyboard navigation (←/→ to browse, Escape to close)
  • Image size filter — filter images by size (Large, Medium, Small) — applied server-side across all engines
  • Autocomplete — live search suggestions as you type (cascades Google → DuckDuckGo → Brave)
  • Pagination — navigate through result pages; URL reflects current state (?q=...&page=2)
  • URL deduplication — duplicate results from multiple engines are merged automatically
  • Domain exclusion — exclude specific websites from search results; settings persist in SQLite
  • Search stats — per-engine result counts, status indicators (ok/error/timeout), collapsible sidebar

Search Engines

  • Google — direct scraping via SearXNG's async progressive response API (asearch=arc); CAPTCHA detection
  • Bing — direct scraping with SearXNG-style cookies and base64 URL decoding; automatic Yahoo fallback on CAPTCHA
  • DuckDuckGo — HTML Lite scraping for web, API for images
  • Brave — Brave Search API for web and images

REST API

  • Full REST API for search, autocomplete, and engine management
  • OpenAPI specification with interactive docs via Swagger UI (/docs) and Redoc (/redoc)

Engine Management

  • 4 built-in engines: Brave, DuckDuckGo, Google, Bing
  • Enable or disable engines via the UI or API at runtime
  • Each engine supports both web and image search categories
  • Google and Bing include automatic fallback mechanisms for resilience

Reliability

  • Retry mechanism — failed upstream requests are retried with exponential backoff (via tenacity)
  • Error reporting — when an upstream engine fails or times out, the UI shows a toast notification identifying which engine had issues
  • Graceful degradation — partial failures don't block results from other engines

UI / UX

  • Mobile-first responsive design built with React, Tailwind CSS, and shadcn theming
  • Clean search home page with branded gradient header
  • Web results show favicons, engine badges, and content snippets
  • Image results displayed in a masonry grid with hover previews and a full lightbox with arrow-key navigation
  • Visited link colors — clicked links turn purple to distinguish from unvisited results
  • Engine settings modal with toggle switches
  • Excluded domains management modal with add/remove UI
  • Unified settings modal — single Settings button opens a tabbed modal (Engines, Excluded Sites)
  • Keyboard navigation for autocomplete suggestions (↑↓ arrows, Enter, Escape)
  • Footer with link to interactive API documentation (Swagger UI)

Deployment

  • Docker — multi-stage Dockerfile: Node.js frontend build → Python production image
  • Backend uses uv for fast, reproducible dependency management
Reference in New Issue View Git Blame Copy Permalink