README.md

metadata

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!