diff --git a/README.md b/README.md
index 8b2cb32..f547e85 100644
--- a/README.md
+++ b/README.md
@@ -1,31 +1,66 @@
-# Online multiplayer Ludo
-## About
+# Online Multiplayer Ludo Game
-**Ludo** is a strategy board game for two to four players, in which the players race their four tokens from start to finish according to the rolls of a single die. Like other cross and circle games, Ludo is derived from the Indian game Pachisi, but simpler. The game and its variations are popular in many countries and under various names. [Read more](https://en.wikipedia.org/wiki/Ludo_(board_game))
-## Interface
-
+\>\> [Play Online here](www.github.com/wenszel/mern-ludo) <<
+
+\>\> [Watch YouTube Video here](www.github.com/wenszel/mern-ludo) <<
+
+## Table of content
+
+- [About](#about)
+
+- [Architecture](#architecture)
+
+- [Key Features and Challenges](#key-features-and-challenges)
+
+- [Tech Stack](#tech-stack)
+
+- [Installation](#installation)
+
+- [Screenshots](#screenshots)
+
+## About
+Ludo Online is a multiplayer web-based implementation of the classic board game Ludo, built using the MERN stack and integrated with SocketIO for real-time communication.
+## Architecture
+
+## Tech Stack
+Frontend:
+  
+  
+Backend:
+   
+Tests:
+ 
+Tools:
+    
+
+## Key Features and Challenges
+
+- Maintained session consistency with **Express Session** and **MongoDB**.
+- Enabled real-time communication via **WebSocket** and **SocketIO**.
+- Ensured code reliability with testing using **Mocha**, **Chai**, and **Jest**.
+- Hosted in a **Docker** container on **AWS EC2**.
+- Established CI/CD using **CircleCI**.
+
+
+## Installation
+1. Download this repository
+2. Generate your own [mongoDB atlas](https://www.mongodb.com) credential URL. It should looks like this:
+
+```
+mongodb+srv://madmin:@clustername.mongodb.net/?retryWrites=true&w=majority
+```
+3. Add this URL to the /backend/credentials.js file
+4. Perform these commands in the main directory:
-## Installation
-Play this game [here](https://smaga-wiktor-ludo.herokuapp.com)
```
npm i
-npm start
+npm start
cd backend
npm i
node server.js
-```
+```
-## Technologies
-### Backend
-- Node.js
-- Express
-- Express-session
-- MongoDB, Mongoose
-- MongoDB sessions store
-- SocketIO
-### Frontend
-- React
-- Axios
-- Material UI
-- Canvas
\ No newline at end of file
+## Screenshots
+
+
\ No newline at end of file
diff --git a/backend/handlers/gameHandler.js b/backend/handlers/gameHandler.js
index 9ef9315..b66348a 100644
--- a/backend/handlers/gameHandler.js
+++ b/backend/handlers/gameHandler.js
@@ -1,4 +1,4 @@
-const { getRoom, updateRoom } = require('../controllers/roomController');
+const { getRoom, updateRoom } = require('../services/roomService');
const { sendToPlayersRolledNumber } = require('../socket/emits');
const { rollDice, isMoveValid } = require('./handlersFunctions');
diff --git a/backend/handlers/handlersFunctions.js b/backend/handlers/handlersFunctions.js
index a457d54..74e5ed5 100644
--- a/backend/handlers/handlersFunctions.js
+++ b/backend/handlers/handlersFunctions.js
@@ -6,7 +6,7 @@ const rollDice = () => {
};
const makeRandomMove = async roomId => {
- const { updateRoom, getRoom } = require('../controllers/roomController');
+ const { updateRoom, getRoom } = require('../services/roomService');
const room = await getRoom(roomId);
if (room.rolledNumber === null) {
room.rolledNumber = rollDice();
diff --git a/backend/handlers/playerHandler.js b/backend/handlers/playerHandler.js
index 825d568..3ff80c9 100644
--- a/backend/handlers/playerHandler.js
+++ b/backend/handlers/playerHandler.js
@@ -1,4 +1,4 @@
-const { getRoom, updateRoom } = require('../controllers/roomController');
+const { getRoom, updateRoom } = require('../services/roomService');
const { colors } = require('../utils/constants');
module.exports = socket => {
diff --git a/backend/handlers/roomHandler.js b/backend/handlers/roomHandler.js
index d01b908..e8a638c 100644
--- a/backend/handlers/roomHandler.js
+++ b/backend/handlers/roomHandler.js
@@ -1,4 +1,4 @@
-const { getRooms, getRoom, updateRoom, createNewRoom } = require('../controllers/roomController');
+const { getRooms, getRoom, updateRoom, createNewRoom } = require('../services/roomService');
const { sendToOnePlayerRooms, sendToOnePlayerData } = require('../socket/emits');
module.exports = socket => {
diff --git a/backend/controllers/roomController.js b/backend/services/roomService.js
similarity index 100%
rename from backend/controllers/roomController.js
rename to backend/services/roomService.js
diff --git a/src/images/architecture.png b/src/images/architecture.png
new file mode 100644
index 0000000..46bf0a6
Binary files /dev/null and b/src/images/architecture.png differ