# 🎮 PWA Quick Start Guide

## Getting Started

1. **Visit:** https://echoesoftheashgame.patacuack.net
2. **Register:** Create a new account with username and password
3. **Login:** Enter your credentials
4. **Play!** Start exploring the wasteland

---

## Interface Overview

### 📊 Stats Bar (Always Visible)
- **❤️ Health** - Your current HP / max HP
- **⚡ Stamina** - Energy for movement and actions
- **📍 Location** - Current area name

### 🗺️ Explore Tab
- **Location Info:** Name and description of where you are
- **Compass:** Move north, south, east, or west
  - Grayed out buttons = no path in that direction
- **Actions:** Rest, Look, Search (coming soon)
- **NPCs/Items:** See who and what is at your location

### 🎒 Inventory Tab
- View your items and equipment
- Note: Being migrated for web users

### 🗺️ Map Tab
- See available exits from your current location
- Interactive map visualization coming soon

### 👤 Profile Tab
- Character stats (Level, XP, Attributes)
- Skill points to spend
- Combat stats

---

## How to Play

### Moving Around
1. Go to **Explore** tab
2. Click compass buttons to travel
3. Each move costs 1 stamina
4. Read the location description to explore

### Managing Resources
- **Stamina:** Regenerates over time (feature coming)
- **Health:** Rest or use items to recover
- **Items:** Check inventory tab

### Character Development
- Gain XP by exploring and combat
- Level up to earn skill points
- Spend points in Profile tab (coming soon)

---

## Mobile Installation

### Android (Chrome/Edge)
1. Visit the site
2. Tap menu (⋮)
3. Select "Add to Home Screen"
4. Confirm installation

### iOS (Safari)
1. Visit the site
2. Tap Share button
3. Select "Add to Home Screen"
4. Confirm installation

---

## Keyboard Shortcuts (Coming Soon)
- **Arrow Keys** - Move in directions
- **I** - Open inventory
- **M** - Open map
- **P** - Open profile
- **R** - Rest

---

## Tips & Tricks

1. **Explore Everywhere** - Each location has unique features
2. **Watch Your Stamina** - Don't get stranded without energy
3. **Read Descriptions** - Clues for quests and secrets
4. **Talk to NPCs** - They have stories and items (coming soon)
5. **Install the PWA** - Works offline after first visit!

---

## Troubleshooting

### Can't Login?
- Check username/password spelling
- Try registering a new account
- Clear browser cache and retry

### Not Loading?
- Check internet connection
- Try refreshing the page (Ctrl+R / Cmd+R)
- Clear cache and reload

### Movement Not Working?
- Check stamina - need at least 1 to move
- Ensure path exists (button should be enabled)
- Refresh page if stuck

### Lost Connection?
- PWA works offline for basic navigation
- Reconnect to sync progress
- Changes saved to server automatically

---

## Features Coming Soon

- ⚔️ Combat system
- 💬 NPC conversations
- 📦 Item pickup and use
- 🗺️ Interactive world map
- 🏆 Achievements
- 👥 Player trading
- 🔔 Push notifications

---

## Need Help?

- Check game logs
- Report issues to admin
- Join community discord (coming soon)

**Happy exploring! 🏜️**