---
title: Reality Swipe
emoji: 🎮
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 7860
pinned: false
---

# 🎮 Reality Swipe

**Match gems, create cascades, and crush levels!** A delightful match-3 puzzle game built with pure JavaScript. No frameworks, no fuss—just pure gaming fun! 🎯

## ✨ What's This?

Think Candy Crush, but **way cooler** because you built it! Drag and swap colorful gems to create matches of 3 or more. Watch the magic happen as pieces cascade down and new combos form automatically. 

## 🚀 Play Now!

Just open `index.html` in your browser and start swiping! No installation, no setup—it just works! 🎉

## 🎯 How to Play

1. **Drag or click** adjacent gems to swap them
2. **Match 3+** gems in a row or column
3. **Watch the cascade** as new pieces fall into place
4. **Reach the target score** to level up!
5. **Beat your best** and see how far you can go! 🏆

## 🎨 Features

- 🎲 **8×8 game board** with 6 colorful gem types
- 💥 **Cascade system** - matches create more matches!
- 📊 **Score tracking** with level progression
- 🎯 **Move limits** for strategic gameplay
- 💡 **Hint system** when you're stuck
- ✨ **Smooth animations** and visual feedback
- 📱 **Responsive design** - play anywhere!

## 🛠️ Built With

- **Pure JavaScript** - No dependencies, just vanilla JS
- **CSS Grid** - Beautiful, responsive layout
- **HTML5** - Modern web standards

## 📁 Files

```
crushgame/
├── index.html    # Game interface
├── game.js        # Game logic & mechanics
├── styles.css     # Styling & animations
└── README.md      # You're reading it! 👋
```

## 🎓 For Developers

Want to customize? The code is clean, well-commented, and easy to modify:

- **Game logic**: Check out `Match3Game` class in `game.js`
- **Styling**: Tweak colors and animations in `styles.css`
- **Mechanics**: Adjust board size, gem types, or scoring in `game.js`

## 🚀 What's Next?

This is a **prototype** ready to become something bigger! Potential next steps:

- 📱 Mobile app (Unity/React Native)
- 🎨 Custom graphics & sprites
- 🔊 Sound effects & music
- 💰 Monetization features
- 🌐 Multiplayer & leaderboards

## 🤝 Contributing

**We'd love your help!** This project is open to contributions of all kinds:

- 🐛 **Bug fixes** - Found a bug? Report it or fix it!
- ✨ **New features** - Got an idea? Let's make it happen!
- 🎨 **Design improvements** - Better UI/UX? We're all ears!
- 📝 **Documentation** - Help make the code more understandable
- 🧪 **Testing** - Play the game and share feedback!

### How to Contribute

1. **Fork the repo** and clone it locally
2. **Create a branch** for your changes (`git checkout -b feature/amazing-feature`)
3. **Make your changes** and test them
4. **Commit** with clear messages (`git commit -m 'Add amazing feature'`)
5. **Push** to your fork (`git push origin feature/amazing-feature`)
6. **Open a Pull Request** and describe your changes!

**No contribution is too small!** Even fixing typos or improving comments helps! 🎉

## 📝 License

MIT License - Feel free to use, modify, and build upon this!

---

**Made with ❤️ and lots of 🎮**

*Ready to level up? Start playing now!*