Among Us Wire Game Clone

A modern implementation of the popular wire-fixing minigame from Among Us, enhanced with an educational quiz mode and theme customization. Test your wire-connecting skills while learning!

🚀 Tech Stack

This project is built with modern web technologies:

• Next.js 14 - React framework with server components and App Router
• TypeScript - For type-safe, maintainable code
• Tailwind CSS - Utility-first CSS for responsive design
• Framer Motion - Smooth animations for wire dragging
• Zustand - State management for game progress
• Shadcn/UI - Accessible UI components
• React DnD - Drag and drop functionality for wires
• React Hot Toast - In-game notifications

✨ Features

• Classic Wire Game: Recreation of the Among Us wire-fixing task
• Educational Quiz Mode: Test your knowledge while fixing wires
• Theme Switching: Dark and light mode support
• Progress Tracking: Track completion times and success rates
• Responsive Design: Play seamlessly on any device
• Accessibility: Full keyboard support and screen reader compatibility
• Sound Effects: Optional audio feedback for actions

🎮 How to Play

Wire Fixing Mode

1. Connect matching colored wires from left to right
2. Drag wires to their corresponding endpoints
3. Complete all connections to win
4. Beat the timer for bonus points
5. Avoid crossing wires for cleaner solutions

Quiz Mode

1. Answer questions by connecting correct pairs
2. Questions appear on the left, answers on the right
3. Match them by dragging wires
4. Score based on accuracy and speed
5. Progressive difficulty levels

🛠️ Installation

# Clone the repository
git clone https://github.com/yourusername/wire-clone-nextjs.git

# Install dependencies
npm install

# Start development server
npm run dev

📱 Development Commands

# Run development server
npm run dev

# Build for production
npm run build

# Start production server
npm run start

# Run tests
npm run test

🎯 Game Modes

Classic Mode

• Traditional wire-fixing gameplay
• Time-based challenges
• Difficulty levels (Easy, Medium, Hard)
• Practice mode available

Quiz Mode

• Educational questions across various subjects
• Category selection
• Difficulty progression
• Score tracking and leaderboards

🎨 Customization

• Dark/Light theme toggle
• Custom wire colors
• Sound effects volume control
• Difficulty settings
• Quiz category selection

🤝 Contributing

We welcome contributions! Please follow these steps:

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

🐛 Bug Reports

Found a bug? Please open an issue with:

• Detailed description of the problem
• Steps to reproduce
• Expected vs actual behavior
• Screenshots if applicable

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Inspired by Among Us by InnerSloth
• Thanks to the Next.js and React communities
• All contributors to this project
• Educational content providers for quiz mode

---

Created with 💡 by uday-nc