From 79d6e71fff67347c8827f43f51b5a82a52388b98 Mon Sep 17 00:00:00 2001
From: Sergio Valor <jaildesigner@gmail.com>
Date: Tue, 23 Dec 2025 13:06:52 +0100
Subject: [PATCH] afegit readme

---
 CMakeLists.txt |  2 +-
 README.md      | 79 +++++++++++++++++++++++++++++++++++++++++---------
 2 files changed, 66 insertions(+), 15 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index a23ba0e..1f512d0 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -1,7 +1,7 @@
 # CMakeLists.txt
 
 cmake_minimum_required(VERSION 3.10)
-project(orni VERSION 0.7.1)
+project(orni VERSION 0.7.2)
 
 # Info del proyecto
 set(PROJECT_LONG_NAME "Orni Attack")
diff --git a/README.md b/README.md
index 1b2bef9..2c74ddf 100644
--- a/README.md
+++ b/README.md
@@ -1,20 +1,71 @@
-# Asteroids
+<div align="center">
+  <img src="https://php.sustancia.synology.me/images/orni_attack/orni_attack_1.png" width="600" alt="Orni Attack">
+</div>
+
+# Orni Attack
+
 Destrueix als cosinus mesisinus que ens ataquen montats en ORNIs!
-<img width="752" src="https://user-images.githubusercontent.com/110221325/184473983-a07c8594-f87c-4e6a-b723-b0a0f8d08e85.png">
+
+---
+
 ## Controls
- * `cursor amunt` accelerar
- * `cursor avall` frenar
- * `cursor dreta` rotar en el sentit de les agulles del rellotge
- * `cursor esquerra`rotar en l'altre sentit
- * `espai` disparar
- * `esc` eixir
- 
-Nomes tens una bala a l'hora. Crec que els teus dispars encara no fan pupa als ORNIs. Pero si ells te toquen sí que rebentes.
 
-## Com jugar hui en dia
+El joc permet l'ús del teclat per a controlar la nau i la finestra. Les tecles són les següents:
 
-Amb DosBox. Augmenta cicles, uns 30000 en el meu macbook.
+| Tecla | Acció |
+|-------|-------|
+| **↑** | Accelerar la nau |
+| **↓** | Frenar |
+| **←** | Rotar a l'esquerra |
+| **→** | Rotar a la dreta |
+| **Espai** | Disparar |
+| **ESC** | Eixir del joc |
+| **F1** | Disminuir la mida de la finestra |
+| **F2** | Augmentar la mida de la finestra |
+| **F3** | Alternar pantalla completa |
 
-## Com compilar hui en dia
+---
 
-Turbo Pascal 7 desde DosBox. No m'ha fet falta activar res.
+## Compilació i execució
+
+### Compilar el joc
+
+```bash
+make           # Compilar
+make debug     # Compilació en mode debug
+make clean     # Netejar fitxers compilats
+./orni         # Executar
+```
+
+### Crear versions release
+
+```bash
+make macos_release     # macOS .app bundle + .dmg (Apple Silicon)
+make linux_release     # Linux .tar.gz
+make windows_release   # Windows .zip (requereix MinGW a Windows)
+make windows_cross     # Cross-compilació Windows des de Linux/macOS
+make rpi_release       # Raspberry Pi ARM64 cross-compilació
+```
+
+---
+
+## Requisits
+
+- **C++20** compatible compiler
+- **SDL3** library
+- **CMake** 3.15 o superior
+
+### Plataformes suportades
+
+- macOS (Apple Silicon i Intel)
+- Linux (x86_64)
+- Windows (MinGW)
+- Raspberry Pi (ARM64)
+
+---
+
+## Història
+
+Joc original creat en **Turbo Pascal 7 per a DOS** (1999), ara migrat a **C++20 amb SDL3**. Aquest port modern preserva la jugabilitat i l'estètica de l'original mentre aprofita les capacitats dels sistemes actuals.
+
+**Versió actual**: BETA 3.0