diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2bb0d47
--- /dev/null
+++ b/README.md
@@ -0,0 +1,63 @@
+# Application de Suivi de Défis GPS
+
+Cette application est une interface web pour suivre des défis géolocalisés en temps réel. Elle utilise Node.js pour le backend et JavaScript/HTML/CSS pour le frontend.
+
+---
+
+## Fonctionnalités
+
+- Affichage d'une carte interactive avec des pins pour les défis.
+- Suivi de la position en temps réel de l'utilisateur.
+- Détection de la proximité d'une cible avec affichage de popups.
+- Mode **debug** pour afficher des informations supplémentaires.
+- Configuration dynamique via un fichier `config.yaml`.
+
+---
+
+## Structure du projet
+
+```plaintext
+.
+├── config.yaml          # Configuration de l'application
+├── data                 # Données des utilisateurs (ex : défis)
+│   ├── baptiste.yaml
+│   └── julien.yaml
+├── static               # Fichiers statiques
+│   ├── css              # Feuilles de style
+│   │   └── style.css
+│   ├── img              # Images pour les pins et avatars
+│   └── js               # Scripts JavaScript
+│       └── script.js
+├── package.json         # Dépendances Node.js
+├── server.js            # Serveur backend (Node.js)
+├── index.html           # Page principale
+└── supervise.html       # Page de supervision
+
+---
+
+## Déploiement de l'Application
+
+### Prérequis
+
+1. **Node.js** :  
+   Installez [Node.js](https://nodejs.org) sur votre machine.
+
+2. **Dépendances** :  
+   Installez les modules Node.js nécessaires. Depuis la racine du projet, exécutez :  
+   ```bash
+   npm install
+
+
+
+
+Création d'un nouveau dépôt en ligne de commande
+touch README.md
+git init
+git checkout -b main
+git add README.md
+git commit -m "first commit"
+git remote add origin http://10.0.0.20:3004/gilles/geocaching_js.git
+git push -u origin main
+Soumission d'un dépôt existant par ligne de commande
+git remote add origin http://10.0.0.20:3004/gilles/geocaching_js.git
+git push -u origin main
\ No newline at end of file