diff --git a/README.md b/README.md
index e69de29..3a9b409 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,90 @@
+# la-Components-wp
+## Описание
+Набор готовых компонентов для Wordpress (tailpress-theme)
+
+## Компоненты:
+
+**language-switcher.php**
+: Переключает язык темы, либо филиалы сайта, если они реализованы через Polylang плагин
+
+**navigation-menu.php**
+: Выводит навигационное меню, по умолчанию используется меню "Шапка сайта", добавлена сео разметка (бредкрамсы и прочее), так как Yoast или другой seo плагин сюда не подцепится.
+
+**footer.php**
+: Скелетон компонент футера
+
+## Блоки
+
+**hero-block.php**
+: Заглавный блок, добавлен без скелетона, для примера вёрстки, стилей и скриптов, есть слайдер и текст из ацф полей. Присутствует лайтбокс.
+
+**gallery-tabs.php**
+: Галерея-слайдер с табами, схожа с reviews-block.php, но есть различия в полях и коде
+
+**reviews-block.php**
+: Галерея с отзывами - галерея-слайдер с табами, есть возможность загружать видеоотзывы и отзывы в виде изображений.
+
+**contacts-block.php**
+: Блок с контактами и яндекс картой, карта подгружена через библиотеку, для возможности стилизации, поддерживается собственная свг иконка для отметки локации, настроено смещение, активация карты по клику, чтобы не блокировать скрол на мобилках. Контейнер с адресом заполняемый через ацф-поле.
+
+**club-card.php**
+: Блок выводит кастомный пост тайп, в текущей реализации есть надстройка через Polylang, чтобы выводить посты относящиеся к выбранному языку 
+
+**Формы**
+: Блоки формы предлагаю делать через плагин fluent forms, выглядит самым гибким из всех существующих, есть невидимые инпуты, чтобы не мучаться в вёрсткой (верстаем обычные инпуты, затем делаем форму с невидимыми инпутами в плагине и просто заполняем их контентом из сверстанных блоков) и хорошая настройка
+
+## Остальное
+
+**modals.php и js/modals.js**
+: Система вывода модалок, создает в футере, общий компонент обертку для модалок, куда потом выводится контент из php-файлов в modals директории.
+: Создаем php-файл в modals с префиксом modal, например modal-example.php c любым содержимым (```<div>Контент</div>``` / ```echo do_shortcode('[fluentform id="1"]')```), затем его можно будет вызывать через button с дата ```data-modal="example"```
+: Есть скелетоны-примеры нескольких модалок
+
+**blocks.php**
+: Файл для регистрации ацф-блоков, есть примеры. Скрипты подключаются через enqueue_scripts в блоке, библиотеки предлагаю по возможности подключать там же, чтобы не грузилась бибилотека если нет блоков используемых ее (как исключение swiper.js или другие библиотеки требуемые в нескольких блоках) 
+
+
+## Установка
+
+### Как отдельный репозиторий
+```bash
+git clone https://git.good-production.xyz/Good-Production/la-components-wp.git
+```
+
+### Как git subtree в проект
+```bash
+git remote add la-components https://git.good-production.xyz/Good-Production/la-components-wp.git
+git subtree add --prefix=template-parts/la-components la-components main
+```
+
+## Использование
+
+### В коде
+```php
+get_template_part('template-parts/la-components/footer');
+```
+
+### Блоки
+Блоки создаются в отдельную категорию и выводятся через gutenberg редактор
+
+### Обновление компонентов в проекте
+```bash
+git subtree pull --prefix=template-parts/la-components la-components main
+```
+
+## Разработка
+Подключить в тему файлы с функциями из компонентов:
+
+```
+$modal_file = get_template_directory() . '/template-parts/la-components/functions/modals.php';
+$block_file = get_template_directory() . '/template-parts/la-components/functions/blocks.php';
+
+if (file_exists($block_file)) {
+require_once $block_file;
+}
+if (file_exists($modal_file)) {
+require_once $modal_file;
+}
+```
+
+И дальше по аналогии.
\ No newline at end of file