diff --git a/README.md b/README.md
new file mode 100644
index 0000000..cbdab02
--- /dev/null
+++ b/README.md
@@ -0,0 +1,36 @@
+# Azzteroid
+
+## 🇫🇷 Français
+
+**Azzteroid** est un jeu simple où il faut tirer sur des astéroïdes le plus longtemps possible afin de marquer un maximum de points.  
+
+Ce jeu a été réalisé pour la borne d'arcade de mon école d’ingénieurs **ISIMA**, dans le cadre du club **Pixel**, qui organise les *game jams* et gère la borne.  
+
+Le jeu propose :  
+- Un **mode solo**  
+- Un **mode 2 joueurs** : les joueurs partagent les 3 vies disponibles.  
+
+Un **scoreboard** est présent pour le mode solo et le mode 2 joueurs.  
+
+### Commandes
+- **Joystick** : déplacement  
+- **Touche A** : tirer (maintenir pour tirer en continu)  
+
+
+---
+
+## 🇬🇧 English
+
+**Azzteroid** is a simple game where you must shoot asteroids for as long as possible to score the highest number of points.  
+
+The game was created for the arcade cabinet at my engineering school **ISIMA**, as part of the **Pixel Club**, which organizes *game jams* and manages the arcade machine.  
+
+The game includes:  
+- A **solo mode**  
+- A **2-player mode**: both players share the 3 available lives.  
+
+A **scoreboard** is available for both solo and 2-player modes.  
+
+### Controls
+- **Joystick**: move  
+- **A button**: shoot (hold to fire continuously)