From 4a54c2a923de20c1e09d4b2c76931a93be1e2dd3 Mon Sep 17 00:00:00 2001
From: SkrinVex <foundationscp11@gmail.com>
Date: Thu, 25 Dec 2025 17:20:14 +0500
Subject: [PATCH] =?UTF-8?q?=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2=D0=B8=D0=BB=20re?=
 =?UTF-8?q?adme?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 78 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 78 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4857fc2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,78 @@
+# 🦊 FoxLang
+
+![Version](https://img.shields.io/badge/version-4.0.0-orange) ![Language](https://img.shields.io/badge/language-C++17-blue) ![License](https://img.shields.io/badge/license-MIT-green)
+
+**FoxLang** — это интерпретируемый язык программирования общего назначения, разработанный с нуля на C++.
+Он сочетает строгий синтаксис (в стиле C++/Java) с динамической гибкостью скриптовых языков. Проект демонстрирует реализацию собственного лексера, рекурсивного парсера, AST-дерева и модульной архитектуры.
+
+> **Главная фишка v4.0:** Умная система импорта, которая позволяет подключать библиотеки, выполняя только объявления функций и игнорируя исполняемый код.
+
+## ✨ Ключевые возможности
+
+- **📁 Модульность:** Подключение файлов через `include("lib.fox")` с поддержкой относительных путей.
+- **📦 Массивы:** Встроенная поддержка создания, чтения и записи массивов (`array`, `set`, `get`).
+- **🔄 Управление потоком:** Полноценные циклы `while` и условия `if/else`.
+- **🔢 Типизация:** Поддержка `int` и `string` с автоматическим приведением типов при выводе.
+- **🛠 Безопасность:** Защита от крашей при сравнении строк и чисел, информативные ошибки синтаксиса.
+- **🎲 Встроенная библиотека:** Генерация чисел, математика, ввод/вывод.
+
+## 🚀 Быстрый старт
+
+### 1. Сборка
+Вам понадобится любой компилятор C++ (GCC, Clang, MSVC).
+
+```bash
+# Перейдите в папку с исходным кодом
+cd src
+
+# Скомпилируйте проект
+g++ main.cpp Lexer.cpp Parser.cpp -o foxlang
+```
+
+*(На Windows будет создан файл `foxlang.exe`)*
+
+### 2. Запуск скрипта
+
+Создайте файл `main.fox`:
+
+```cpp
+print("Hello, FoxLang!");
+fox();
+```
+
+Запустите его:
+
+```bash
+./foxlang main.fox
+```
+
+## 💻 Пример кода
+
+```cpp
+// Подключаем библиотеку (код внутри не выполняется, только функции запоминаются)
+include("math_lib.fox");
+
+int x = 10;
+
+if (x > 5) {
+    print("X is big!");
+} else {
+    print("X is small.");
+}
+
+// Работа с массивом
+array nums 3;
+set(nums, 0, 555);
+print("Array elem: " + get(nums, 0));
+```
+
+## 📂 Структура проекта
+
+* `src/` — Исходный код интерпретатора (C++).
+* `test/` — Примеры скриптов `.fox`.
+* `doc/` — Документация.
+
+---
+
+**Author:** [SkrinVex]  
+**License:** MIT
\ No newline at end of file