Single type that all data sources map to — board games, video games, word games all in one format.

Full integration with BoardGameGeek XML API2 — Bearer token auth, XML parsing, 202 retry logic, suggested player count polls.

80k+ video games from RAWG API with metacritic, ESRB, platforms, genres, screenshots.

47 curated word and party games including 27 "no equipment needed" games like Charades, Mafia, 20 Questions.

PostgreSQL with pgvector extension, RLS policies, indexes, full-text search, and vector similarity.

Bulk import from Kaggle dataset with mechanics, themes, categories, designers, publishers.

Scanning 400k BGG IDs to replace Kaggle data with real descriptions, ratings, and full metadata from the live API.

Automated pagination with exponential backoff, detail backfills for descriptions and extended metadata.

20k+ video games from IGDB with rich genres, themes, keywords. Twitch OAuth2, Apicalypse queries. Much richer metadata than RAWG.

Removed 13k duplicate games that existed in both RAWG and IGDB, keeping the richer IGDB version.

Signup, login, session refresh proxy, cookie-based auth.

Stats dashboard, favorites, reviews, saved presets — all in one tabbed view.

Name and save questionnaire preferences for quick re-use without answering all questions again.

1-10 rating + text review per game. Reviews are publicly readable, own-write.

Bookmark games to a personal library with one-click add/remove.

Popularity mode (popular/any/hidden gems), minimum rating, source toggles.

One-click Google login via Supabase + Google Cloud OAuth 2.0. PKCE flow with cookie-based code verifier for SSR compatibility.

LocalStorage preferences auto-saved on questionnaire submit, restored on next visit. Signup prompt after 3 recommendations. Guest favorites (limited to 5).

Game type → player count → time → complexity → genres → mood → free text, with slide transitions between steps.

Select multiple game types (board + video) and time ranges simultaneously.

Type "I like roguelike games" and the engine extracts keywords to boost matching games. Handles multi-word terms like "deck building" and "social deduction."

Each recommended game shows reason chips explaining why it was picked.

Date Night, Quick Play, Party Night, Strategy Deep Dive — one-click preset recommendations.

Full game catalog with source, type, and tag filters + server-side pagination.

Full game info, similar games section, review form, favorite button.

GPT-4o extracts structured preferences from natural language. Negative preferences ("no war games"), exact time extraction ("under 30 min"), auto-detects board game from mechanics. Two-tier cache with fuzzy matching.

10 weighted dimensions: type, players, time, complexity, genre, mood, free text, quality, popularity, recency. Soft preferences with fallback — never returns zero results.

768-dim hash embeddings + 1536-dim OpenAI semantic embeddings. Cosine similarity via HNSW index.

Item-based and user-based collaborative filtering. "Users who liked Catan also liked Ticket to Ride." Activates when enough reviews exist.

Reviews and favorites update the user's preference vector in real-time. The system learns what you like with each interaction.

5 parallel sources: 250 by vector similarity + 250 by rating + tag-based GIN lookup + full-text search + popularity cache. Deduplicated and scored.

MMR algorithm prevents 20 strategy games in a row. Ensures category/mechanic spread in results.

"Not This" feedback penalizes games with similar tags in future recommendations.

Interactive feedback on every result card. Thumbs-down removes and records negative signal. More Like This re-searches with that game's attributes.

Indigo + Coral + Teal + Amber palette applied across all components with MUI theme tokens.

Motion-powered hero with parallax scroll, stagger reveals, floating dice decorations, and animated stat counters.

Physics-correct rigid body rotation with quaternion integration, precession for multi-axis tumble, parabolic bounce arcs. Natural 20 = confetti. Natural 1 = blood drips + screen shake.

Skeleton cards during game loading for perceived performance.

Full light/dark mode via createAppTheme. System default detection, localStorage persistence, toggle in header + mobile nav + settings page.

Game Night Glow, Ocean Breeze, Neon Arcade, Forest Grove, Sunset Mesa, Midnight Royal. Picker in Settings UI with color swatches.

GameLoader component with 3 variants: bouncing dice, shuffling cards, swaying magnifying glass. Context-aware.

Game cards slide up with staggered 40ms delay per index. Motion spring physics for natural feel.

AnimatedRating component counts up from 0.0 to value over 800ms, delayed until after card reveal.

12 colored particles burst (mixed circles + squares), heart bounces with spring animation, optimistic update.

Thin gradient line (indigo→coral), direct DOM manipulation via requestAnimationFrame for zero latency.

Fade-in on route change. (No exit animation — Next.js App Router limitation.)

Mobile-only cover art scrolls at 40% speed with gradient overlay on game detail pages.

500ms enter delay globally, styled with rounded corners + shadow, descriptive not duplicative.

Emoji wiggle on button hover (CSS keyframe), hover lift (motion), tap scale.

Green/yellow/gray % match badges on every result card based on score.

Mobile-first refinements across all pages.

Replaced 100+ emojis with Lucide React icons across 25 files. Consistent, professional iconography.

Manifest, service worker, PWA icons (dice design). Add to homescreen ready.

Skip-nav link, aria-labels on all IconButtons, form accessibility verified.

Production deployment with auto-deploy from main branch.

Cloudflare DNS, SSL, email routing (info@ + contact@). Full rebrand from "Recommend a Game".

Dynamic OG + Twitter images via Next.js ImageResponse. Share menu with Copy Link, Twitter/X, Facebook, Reddit.

GPT-4o daily blog generation with 365 rotating topics. Vercel cron at 6am UTC. SEO-optimized with affiliate links and internal game links.

Buy buttons on every game card and detail page. Tag: boredgame-20. Board games link to Amazon, video games to Steam.

Supabase confirm email enabled with branded templates (signup, reset, change).

robots.txt, sitemap.xml, JSON-LD (WebSite, BoardGame, VideoGame, FAQPage, BlogPosting), canonical URLs, Google Search Console, Google Analytics.

Contact page, FAQ page, feedback button (sends via Resend to email), "why did you dislike this?" popover on thumbs-down.

/invite page with share button. Web Share API on mobile, clipboard on desktop.

Email capture on landing page. Supabase storage. Ready for Mailchimp/Resend integration.

43 achievements across 8 categories — all with active triggers. Dice, Discovery, Social, Reviews, Settings, Easter Eggs, Time, and Meta. Animated toast notifications with rarity-colored borders.

Full dice creator with colors, materials, textures. Public sharing via Dice Gallery. Voting/leaderboard. Custom uploads.

Deterministic high-rated game of the day on homepage. Redis cached. Only well-known games (7.0+ rating, 500+ votes, with image).

Thumbs-down removes game from results and records negative feedback. Rejection learning penalizes similar games in future.

Re-runs engine seeded with that game's categories and mechanics. Instant discovery from any result.

Green/yellow % match badges on each result card showing recommendation confidence.

POST /api/feedback with upsert to user_game_feedback table. Supports thumbs-up and thumbs-down.

GPT-4o-mini parsing with DB enrichment, two-tier fuzzy cache, and smart questionnaire pre-fill.

Expanded genres (50+), mechanics (30+), tone/intensity detection, natural language player count, better examples.

20k+ games from IGDB with rich genres, themes, keywords. "A metroidvania about bugs" now finds Hollow Knight.

Upstash Redis caching on recommend (2min), browse (5min), game detail (10min), similar games (10min).

1536-dim embeddings via text-embedding-3-small. Captures meaning — "build your deck" matches "Deck Building" even without exact tags.

Connect BGG username to import collection and ratings. Auto-converts to internal feedback signals. Onboarding prompt for logged-in users.

Second-stage reranker reviews top 25 candidates and picks the best matches using board game knowledge. Catches everything rule-based scoring misses.

Creative intent understanding for any input. Expands "spaghetti and meatballs" into food/cooking themes. Runs in parallel with candidate fetch.

Maps common terms to BGG taxonomy. "Deck Building" -> "Deck, Bag, and Pool Building". 25+ aliases for reliable mechanic matching.

FAQ page, onboarding dialog for first-time users, BGG sync prompt for logged-in users.

Replaced ILIKE full table scans with GIN-indexed tsvector RPCs. Biggest single speedup.

Indexes matching exact browse and recommend query patterns. Partial indexes for popularity modes.

Pre-computed name_tsv and description_tsv columns with GIN indexes. Instant full-text search.

Shared GAME_SELECT_COLUMNS (23 cols) replaces SELECT * (40+ cols). ~50% less data transfer.

Each candidate fetcher wrapped in 8s timeout. Recommend always responds even if one source is slow.

38 Redis lists with 1,390 games. Instant fallback for cold starts and common queries.

Removed WHERE clause that was defeating HNSW index performance. Vector search went from timeout to ~1s.