landing page

README.md

@@ -1,12 +1,53 @@
 ---
 title: Spaceship Game
-emoji: 👋
+emoji: 🚀
 colorFrom: red
 colorTo: blue
 sdk: static
 pinned: false
-short_description: Write your description here
+short_description: A 3D space shooter controlled by Reachy Mini's head movements and antennas
 tags:
  - reachy_mini
  - reachy_mini_python_app
----
+---
+
+# Spaceship Game
+
+A 3D space shooter game for Reachy Mini where you control a spaceship using the robot's head movements and fire weapons by pulling the antennas. Features wave-based gameplay with increasing difficulty.
+
+![Spaceship Game Screenshot](spaceship_game/assets/screenshot.png)
+
+## Features
+
+- **Physical Controls**: Move Reachy Mini's head to aim the spaceship in 3D space
+- **Dual Weapons**: Pull left and right antennas independently to fire guns
+- **Wave System**: Face increasingly difficult waves of enemy ships
+- **Three Enemy Types**: Red (basic), Orange (fast/aimed), Purple (heavy/spread)
+
+## Setup
+
+### 1. Install Dependencies
+
+```bash
+pip install -e .
+```
+
+### 2. Run the Game
+
+Run the app through the Reachy Mini app manager or directly:
+
+```bash
+python -m spaceship_game.main
+```
+
+## How to Play
+
+1. **Start**: Aim at the glowing button and pull an antenna to start
+2. **Aim**: Tilt head up/down and turn left/right to aim the spaceship
+3. **Fire**: Pull the left or right antenna down to shoot the respective gun
+4. **Survive**: Destroy enemies and dodge their bullets
+5. **Score**: Each enemy type gives different points (Red: 100, Orange: 150, Purple: 300)
+
+## Game Over
+
+When your health reaches zero, shoot the restart button to play again!

index.html

@@ -122,8 +122,9 @@
 	<div class="container">
 		<div class="main-card">
 			<div class="app-preview">
-				<div class="game-preview">
-					<div class="game-preview-text">🎮 SHMUP GAME 🎮</div>
+				<div class="game-preview" style="margin-bottom: 2rem;">
+					<img src="spaceship_game/assets/spaceship.gif" alt="Spaceship Game Screenshot" style="width: 100%; border-radius: 8px; margin-bottom: 1rem;">
+					<div class="game-preview-text">🎮 GAMEPLAY 🎮</div>
 					<p style="color: #fff; text-align: center; font-family: 'Courier New', monospace;">
 						Control a spaceship in 3D space<br>
 						Fight waves of enemy ships<br>
@@ -131,6 +132,10 @@
 						<span style="color: #ff0;">Score points and survive!</span>
 					</p>
 				</div>
+				<div class="game-preview">
+					<img src="spaceship_game/assets/spaceship_control.gif" alt="Spaceship Control Demo" style="width: 100%; border-radius: 8px; margin-bottom: 1rem;">
+					<div class="game-preview-text">🤖 CONTROLS 🤖</div>
+				</div>
 			</div>
 
 			<div class="app-details">