diff --git a/README.md b/README.md
index e69de29..347e92b 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,38 @@
+# 🌸 Portfolio – Aya Ben Mabrouk
+
+Bienvenue sur mon portfolio !  
+Je suis **Aya Ben Mabrouk**, étudiante en **2ème année de BTS CIEL (Cybersécurité, Informatique et Électronique)**.  
+Ce site présente mes compétences, mes projets ainsi que mon expérience professionnelle, notamment mon stage en clinique.
+
+---
+
+## 🚀 Technologies utilisées
+
+- **HTML5 / CSS3 / JavaScript**
+- **Docker & Docker Compose**
+- **Devicon (icônes professionnelles)**
+- **Organisation de projet propre en architecture `/src`**
+
+---
+
+## 🐳 Lancer le projet avec Docker
+
+Assurez-vous d’avoir Docker installé, puis exécutez :
+
+cd ~/Documents/portfolio
+
+Lien :  http://localhost:8080
+```bash
+./init.sh
+
+.
+├── docker-compose.yml
+├── Dockerfile
+├── init.sh
+└── src/
+    ├── index.html
+    ├── style.css
+    ├── script.js
+    └── assets/
+        └── portrait_aya.jpg
+