diff --git a/README.md b/README.md
index cd3e0e2..2f04649 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,58 @@
-# tkinter-designer README
-Тут можно создавать формы на tkinter :)
+# Tkinter Form Designer
 
+**Tkinter Form Designer** — это расширение для Visual Studio Code, которое позволяет визуально создавать графические интерфейсы (GUI) для Python библиотеки `tkinter` с помощью простого перетаскивания (Drag & Drop).
+
+Расширение автоматически генерирует Python-код в реальном времени.
+
+## Основные возможности
+
+*   **Drag & Drop редактор:** Перетаскивайте элементы на форму и расставляйте их мышкой (используется абсолютное позиционирование `.place()`).
+*   **Двусторонняя связь:**
+    *   Изменения в редакторе мгновенно обновляют `.py` файл.
+    *   Возможность **импорта** существующего Python-кода обратно в визуальный редактор. Импортируемый файл должен иметь ту же структуру, что и файлы, генерируемые этим расширением.
+*   **Набор виджетов:**
+    *   Label, Button, Entry, Text (многострочный ввод).
+    *   Checkbox, Radiobutton.
+    *   Listbox (с настройкой элементов списка).
+    *   Canvas (холст).
+    *   **Frame** (поддержка вложенности: можно перетаскивать виджеты внутрь фреймов).
+*   **Настройка свойств:**
+    *   Изменение координат (X, Y) и размеров (Width, Height).
+    *   Настройка цветов (Background, Foreground).
+    *   Редактирование текста и содержимого.
+*   **Настройки главного окна:** Изменение заголовкаи и размеров основного окна через удобное меню.
+*   **Undo / Redo:** Полная поддержка отмены и повтора действий (`Ctrl+Z`, `Ctrl+Y`) с синхронизацией кода.
+
+## Установка
+
+Так как расширение находится в формате `.vsix` (локальный пакет):
+
+1.  Скачайте файл `tkinter-designer-0.0.1.vsix`.
+2.  Откройте VS Code.
+3.  Перейдите на вкладку **Расширения** (Extensions) `Ctrl+Shift+X`.
+4.  Нажмите на меню (три точки) в правом верхнем углу панели.
+5.  Выберите **"Install from VSIX..."**.
+6.  Укажите файл расширения.
+
+## Как использовать
+
+1.  **Создание проекта:**
+    *   Создайте пустой файл с расширением `.tkjson` (например, `app.tkjson`).
+2.  **Запуск редактора:**
+    *   Дважды кликните по файлу `.tkjson`. Откроется визуальный редактор.
+    *   Рядом автоматически создастся файл `app.py` с кодом.
+3.  **Редактирование:**
+    *   Перетаскивайте виджеты из палитры справа.
+    *   Настраивайте их свойства в панели "Settings" (иконка шестеренки при выборе элемента).
+    *   Для настройки размера окна нажмите иконку шестеренки в правом верхнем углу панели инструментов.
+4.  **Импорт кода (Обратная разработка):**
+    *   Если вы написали код вручную в `.py` файле, нажмите кнопку **Import** в панели инструментов редактора.
+    *   Выберите ваш `.py` файл, и форма в редакторе перестроится согласно коду.
+
+## Требования
+
+*   **VS Code** версии 1.75.0 или выше.
+*   **Python 3** (для запуска сгенерированного кода).
+
+---
+*Разработано в рамках производственной практики. 2025 г.*
\ No newline at end of file