Enhance app with features and mobile support

README.md

@@ -1,14 +1,89 @@
-# JavierExperiance
-JavierGame is a web-based game built using JavaScript and HTML.
+# Javier The Experience 🐵
 
-## Features
-- **Dynamic Gameplay**: monkey.
-- **Responsive Design**: Works fast on chromeos lol.
-- **Lightweight**: its small.
+A fast-paced 2D side-scrolling action game featuring Javier, a powerful monkey fighter. Battle waves of enemies, collect coins, unlock achievements, and survive as long as you can!
+
+## ✨ Features
+
+### Core Gameplay
+- **Dynamic Combat System**: Punch enemies, build lightning charge, and unleash devastating attacks
+- **Round-Based Progression**: Face increasingly difficult waves of enemies
+- **Multiple Enemy Types**: Basic, Fast, Tank, Jumper, and Mini enemies with unique behaviors
+- **Shop System**: Upgrade your strength, speed, and health with coins earned in battle
+
+### New Features
+- **🎮 Mobile Support**: Full touch controls with virtual joystick and buttons
+- **🔥 Combo System**: Chain kills for bonus points and multipliers
+- **⚡ Power-Ups**: Collect speed, damage, and health boosts that spawn every 3 rounds
+- **🏆 Achievement System**: Unlock achievements for various milestones
+- **📊 Enhanced Stats Display**: Track kills, rounds, combos, and more
+- **💾 Auto-Save**: Your progress is automatically saved
+- **🎨 Modern UI**: Beautiful glassmorphism design with smooth animations
+
+### Quality of Life
+- **Responsive Design**: Works perfectly on desktop, tablet, and mobile devices
+- **Visual Feedback**: Damage indicators, combo displays, and achievement notifications
+- **Performance Optimized**: Smooth 60fps gameplay
+- **Accessibility**: Clear controls and visual indicators
+
+## 🎮 Controls
+
+### Desktop
+- **A/D or Arrow Keys**: Move left/right
+- **Space or Up Arrow**: Jump
+- **J**: Punch attack
+- **H**: Lightning strike (when charged)
+- **S**: Open shop
+- **Escape**: Pause
+
+### Mobile
+- **Virtual Joystick**: Move and jump
+- **👊 Button**: Punch
+- **⚡ Button**: Lightning attack
+- **⬆️ Button**: Jump
+
+## 🚀 Getting Started
 
-## Installation
 1. Clone the repository:
    ```bash
    git clone https://github.com/HenryTheAddict/JavierGame.git
-2. Open the html.
-3. wow
+   ```
+
+2. Open `index.html` in your web browser
+
+3. Click "Start Experience" and begin your adventure!
+
+## 🎯 Gameplay Tips
+
+- Build combos by killing enemies quickly for bonus points
+- Save your lightning attack for tough situations
+- Collect power-ups that spawn every 3 rounds
+- Upgrade your stats in the shop between rounds
+- Health regenerates after 6 seconds without taking damage
+
+## 🏆 Achievements
+
+- **First Blood**: Kill 10 enemies
+- **Slayer**: Kill 50 enemies
+- **Massacre**: Kill 100 enemies
+- **Combo Master**: Achieve a 10x combo
+- **High Roller**: Score 1000 points
+- **Survivor**: Reach round 5
+
+## 🛠️ Technical Details
+
+- Built with vanilla JavaScript and HTML5 Canvas
+- No external dependencies
+- Responsive design with CSS media queries
+- LocalStorage for save data
+- Optimized for 60fps gameplay
+
+## 📱 Mobile Support
+
+The game is fully optimized for mobile devices with:
+- Touch-friendly controls
+- Responsive canvas sizing
+- Virtual joystick for movement
+- Large, easy-to-tap buttons
+- Prevents accidental scrolling
+
+Enjoy the experience! 🎮