add repo description

Author: daria-z

Makefile

@@ -1,6 +1,12 @@
 install:
 	npm ci
 
+publish:
+	npm publish --dry-run
+
+lint:
+	npx eslint .
+
 brain-games:
 	node bin/brain-games.js
 
@@ -15,9 +21,3 @@ brain-progression:
 
 brain-prime:
 	node bin/brain-prime.js
-
-publish:
-	npm publish --dry-run
-
-make lint:
-	npx eslint .

README.md

@@ -1,8 +1,59 @@
-### Hexlet tests and linter status:
-[![Actions Status](https://github.com/daria-z/frontend-project-44/actions/workflows/hexlet-check.yml/badge.svg)](https://github.com/daria-z/frontend-project-44/actions)
+# 🌟 **Frontend Project 44** 🌟
 
+### 🚦 **Hexlet tests and linter status**
+[![Actions Status](https://github.com/daria-z/frontend-project-44/actions/workflows/hexlet-check.yml/badge.svg)](https://github.com/daria-z/frontend-project-44/actions)
 [![Maintainability](https://api.codeclimate.com/v1/badges/49edea7ca409bfa4fe91/maintainability)](https://codeclimate.com/github/daria-z/frontend-project-44/maintainability)
 
-[brain-even game](https://asciinema.org/a/YPfOFw8I5n6o7xdPNqcPEZQNS)
 
-[brain-calculator game](https://asciinema.org/a/ONmzvy0r18Tos1PymICQsgmD7)
+## 📦 Installation and Setup
+
+To get started, follow these steps:
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/daria-z/frontend-project-44.git
+   cd frontend-project-44
+   ```
+
+2. Install dependencies:
+   ```bash
+   npm install
+   ```
+
+3. Start the project:
+   ```bash
+   npm start
+   ```
+
+### 🛠️ **Makefile**
+
+- **`make install`**
+  installs all project dependencies using npm.
+
+- **`make lint`**
+  runs the linter to check the code for style issues and potential errors.
+
+**Commands to Run Games**
+
+- **`make publish`**
+
+- **`make brain-games`**
+
+- **`make brain-even`**
+
+- **`make brain-calculator`**
+
+- **`make brain-progression`**
+
+- **`make brain-prime`**
+
+## 📂 Project Structure
+```
+frontend-project-44/
+├── src/
+│   ├── games-logic/    # Core game logic and mechanics
+│   └── utils/          # Utilities and helper functions
+├── bin/                # Executable scripts
+├── Makefile            # Automation commands
+└── README.md           # Documentation
+```