# Game Sites

> A Next.js-based HTML5 game aggregator platform serving games from multiple sources with a modern, responsive interface.

This is a static game catalog website built with Next.js 15, React 19, TypeScript, and Tailwind CSS 4. The platform aggregates and displays games from various platforms, featuring both self-hosted HTML5 games and embedded third-party games.

## Key Features

- Game catalog with 200+ games from multiple platforms
- Static site generation for optimal performance
- Game search and platform filtering
- Responsive masonry layout with game cards
- Fullscreen iframe player with fallback support
- Daily randomized homepage collections (date-seeded shuffle)

## Documentation

- [Developer Guide](CLAUDE.md): Complete architecture overview, commands, and development patterns
- [README](README.md): Project structure, setup instructions, and technologies
- [Game Library](/src/lib/games.ts): Core utilities for game data fetching and URL handling

## Architecture

- **App Router**: Pages at `/`, `/game/[slug]`, `/game/[slug]/play`, `/search`
- **Data Source**: `/public/games.json` contains the complete game catalog
- **Static Assets**: Self-hosted HTML5 games in `/public/html5/`
- **Components**: `GameCard`, `GamePlayer` for display and playback
- **Image Optimization**: 512×512 PNG icons with sharp-based compression workflow

## Commands

```bash
pnpm dev          # Start development server (http://localhost:3000)
pnpm build        # Build standalone production output
pnpm lint         # Run ESLint checks
```

## Tech Stack

- Next.js 15 (App Router, standalone output)
- React 19
- TypeScript 5
- Tailwind CSS 4
- Deployed to Cloudflare Pages