README.md

Star Wars Character Quiz

Test your knowledge of Star Wars characters in this interactive quiz game! Available in two difficulty modes, this game challenges players to identify characters from the Star Wars universe.

🎮 Play Now

Features

• Two Game Modes:

  • 🎓 Padawan Mode: Multiple choice answers for beginners
  • 👑 Master Mode: Type the character's name for a true challenge

• Engaging Gameplay:

  • Dynamic character images from the Star Wars universe
  • Helpful hints about characters' background
  • Score tracking system
  • Three lives per game
  • Forgiving spelling system in Master Mode

• Leaderboard System:

  • Save your high scores
  • Compete for the top 10 positions
  • Separate tracking for Padawan and Master modes

Technology Stack

• React 18
• TypeScript
• Tailwind CSS
• Vite
• Lucide React for icons

Development

Prerequisites

• Node.js (v14 or higher)
• npm or yarn

Installation

1. Clone the repository

git clone <repository-url>
cd star-wars-character-quiz

2. Install dependencies

npm install

3. Start the development server

npm run dev

4. Build for production

npm run build

Game Rules

1. You start with 3 lives

2. In Padawan Mode:

   • Choose from 4 multiple choice options
   • Each correct answer adds 50 points
   • Incorrect answers cost one life

3. In Master Mode:

   • Type the character's name
   • Each correct answer adds 100 points
   • Close spelling matches earn 75 points
   • Incorrect answers cost one life

API Credits

This project uses:

• SWAPI for Star Wars character data
• Star Wars Visual Guide for character images
• Unsplash for fallback images

License

MIT License - feel free to use this project for learning, modification, and sharing!