diff --git a/README.md b/README.md
index 34eca27..2d62e74 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,41 @@
-# gpt-bomber
+# GPT Bomber
 
-GPT codex written bomberman clone
\ No newline at end of file
+A fully original Bomberman-style browser game built from scratch.
+
+## Features
+- Grid-based bomb combat with chain reactions
+- Destructible crates and hidden powerups (bomb, flame, speed)
+- 3 CPU opponents with survival + attack behavior
+- Original visual assets (logo, characters, tiles, icons) in local SVG files
+- Original procedural audio (looping music + SFX) synthesized with Web Audio
+- Keyboard and controller support
+- Startup menu with mode selection (`Single Player` / `Multiplayer`) and music toggle
+- Multiplayer name setting from menu (`Name: ...`) with local persistence
+- Multiplayer lobby with host-controlled start (can start with 1-4 players)
+- After each multiplayer round, host can start the next round directly (no lobby required)
+- Host-authoritative multiplayer sync via WebSocket backend
+
+## Run
+Install dependencies and run the backend server:
+
+```bash
+npm install
+npm start
+```
+
+Then open:
+
+```text
+http://localhost:8080
+```
+
+## Controls
+- Move: `WASD` or `Arrow Keys`
+- Bomb: `Space` or `Enter`
+- Menu: `Esc` / `P`
+- Menu Select: `Enter` / `Space`
+- Controller: `D-pad` move, `A` bomb/select, `Start` open menu
+
+## Multiplayer Notes
+- For LAN/internet play, run the server on a reachable machine and open `http://<server-ip>:8080` from each client.
+- The first active lobby player becomes host and can start with fewer than 4 players.