V1.0.0

---
id: tile-merge-puzzle
version: 1.0.0
category: game-generation
title: Tile Merge Puzzle (2048-style)
description: Build a complete playable browser game inspired by the famous 2048 tile-merging puzzle.
---

Build a **complete, playable** tile-merging puzzle game in the style of the famous **2048** puzzle (MIT-licensed original — use only generic mechanics, no copied assets or branding).

## Game concept

A 4×4 grid where numbered tiles slide and merge. Combine matching tiles to reach higher values. The game is famous worldwide — implement the core loop faithfully while using your own visual design.

## Required game parts (all must work)

1. **Title screen** — game name, short instructions, "Press Space or click to start"
2. **Play state** — 4×4 grid, score display, best score (persist with `localStorage`)
3. **Tile logic** — spawn a `2` (90%) or `4` (10%) after each valid move; merge equal adjacent tiles in the moved direction (one merge per tile per move)
4. **Controls** — arrow keys (and optional swipe on touch)
5. **Win detection** — reaching the 2048 tile shows a win overlay with "Keep playing" and "New game"
6. **Game over** — no empty cells and no possible merges; show game-over overlay with final score and "Try again"
7. **New game** — reset grid, score, and state from title or overlays

## Technical requirements

1. Output **only** a single fenced `html` code block containing the full page. No explanation outside the code block.
2. Self-contained: embedded CSS and JavaScript only. No external libraries, fonts, or images.
3. Use semantic HTML5. The game must be **immediately playable** when the page loads in a browser.
4. Smooth but lightweight UI — colored tiles by value (e.g. 2=light, 4=warm, 8=orange, higher=darker), readable numbers, subtle transitions.
5. Include a visible **controls hint** on screen (e.g. "Arrow keys to move").
6. Do **not** implement Snake, Flappy Bird, Tetris, Pac-Man, or other unrelated games.
7. Do **not** use copyrighted sprites, sound files, or trademarked names beyond a generic title like "Tile Merge" or "2048 Puzzle".

The result should feel like a polished indie browser game — not a broken prototype.