# SiteHub

Website: https://sitehub-app.vercel.app

Description:
SiteHub is a meticulously curated web directory offering two distinct experiences: "Pro Sites" (premium, hand-picked platforms vetted for reliability) and "Community Sites" (user-submitted gems). It spans across 11 main categories including Movies, Anime, Tools, AI, Live TV, Education, Live Sports, Music, Gaming, and VPNs. SiteHub aims to provide the internet's best sites in one clean, fast, and interactive directory.

Core Features:
- Dual-Mode Directory: Seamlessly toggle between Pro and Community listings.
- Advanced Global Search: Multi-field fuzzy matching (Levenshtein + Jaro-Winkler + trigrams) with typo tolerance and real-time autocomplete (Cmd/Ctrl + K).
- Keyboard Navigation: Full spatial D-pad/WASD navigation across the entire UI for desktop users.
- Automated Health Checks: Daily cron jobs ping every site to ensure zero dead links.
- Sophisticated Ranking Algorithm: Hourly updates for popular sites based on visits, likes, and recency.
- Engagement & Social: One-click saves, real-time likes, threaded comment system.
- Interactive UI: Confetti celebrations, 3D particle background (Three.js), and Framer Motion micro-animations.

Data Structure (Sites):
- title / name
- description
- url
- category (array)
- type (Pro vs. Community)
- tags
- popularity (visits, likes)
- status (online/offline)
- slug

Key API Endpoints:
- /api/search/global - Advanced search across all content
- /api/sites - Retrieve approved sites with filtering
- /api/cron/check-sites - Trigger daily site status check
- /api/cron/update-popular - Trigger hourly ranking updates
- /api/submit - Submit community sites

Technical Stack:
- Frontend: Next.js 16 (App Router), TypeScript 5.7, Tailwind CSS v4, shadcn/ui, Framer Motion, Three.js
- Backend/Database: Supabase (PostgreSQL with RLS), Edge API Routes
- Infrastructure: Vercel (Hosting), Upstash Redis (Rate Limiting), PostHog (Analytics)

Security Policies:
- SSRF Protection: DNS resolution and private IP blocking on all URL operations.
- Rate Limiting: Upstash Redis sliding window protection on every endpoint.
- Sanitization: All user inputs validated via Zod and stripped of HTML.