diff --git a/README.md b/README.md
index c6555fe..d783ce3 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,37 @@
-# ed
+# 🟡 Space Jump
 
-Edddd
\ No newline at end of file
+Мини-игра-раннер на чистом HTML, CSS и JavaScript — без библиотек и сборки.
+
+Жёлтый квадратик бежит по платформе, навстречу летят красные препятствия.
+Перепрыгивай их и набирай очки — с каждым очком скорость растёт.
+
+## 🎮 Управление
+
+| Действие | Клавиша |
+|---|---|
+| Старт / прыжок | **Пробел** |
+| На телефоне | Тап по экрану |
+
+## ✨ Особенности
+
+- Счёт и рекорд (сохраняется в `localStorage`)
+- Плавная физика прыжка с гравитацией
+- Скорость растёт по мере игры
+- Работает на телефоне (тап вместо пробела)
+- Никаких зависимостей — просто открой `index.html`
+
+## 🚀 Запуск
+
+```bash
+git clone https://git.exest.fun/exest/ed.git
+cd ed
+open index.html
+```
+
+## 📁 Структура
+
+```
+index.html  — разметка игры
+style.css   — оформление
+script.js   — логика: физика, препятствия, счёт
+```