diff --git a/README.md b/README.md
index a73ee89..3d9749f 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,30 @@
-# credit-card
-Учебный проект "Credit Card Payment Form" - это веб-приложение для создания виртуальной кредитной карты
+
Приложение для создания виртуальной банковской карты
+
+
+
+:link: Ссылка на проект: https://nadezhda-v.github.io/credit-card/
+
+Описание проекта
+Проект представляет собой приложение для создания и визуализации банковских карт и предоставляет информацию о платежной системе и банке, выпустившем карту.
+
+
+Установка и запуск приложения
+
+1. `git clone https://github.com/Nadezhda-v/credit-card.git` - клонировать репозиторий
+2. `npm i` - установить зависимости
+3. `npm run dev` - запуск приложения в режиме разработчика
+
+ /\*если приложение не запустилось автоматически, в браузере ввести ссылку `http://localhost:3000/`\*/
+
+Возможности
+
+ - Визуализация банковской карты с введенными данными
+
- Автоматическое определение бренда карты
+
- Отображение логотипа банка
+
- Валидация данных и сообщения об ошибках
+
- Возможность переворачивать карту для просмотра CVV-кода
+