Skip to content

AjaysDevWorkspace/SnakeEvolution

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

31 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🐍 Snake: Evolution

A modern twist on the classic Nokia Snake game — now with powerups, leaderboards, and Google authentication!


📖 About

Snake: Evolution is a modern, enhanced version of the classic Snake game built with HTML, CSS, and JavaScript. It brings back the retro fun with a fresh feel and features like real‑time leaderboards, Google login, and evolution powerups.

Designed for both nostalgic players and newcomers, this game combines old‑school arcade fun with modern features for an immersive experience.


🎮 Features

  • 🎮 Classic Snake Gameplay: Smooth, responsive controls with sleek pixel‑art visuals.
  • Evolution Powerup: Temporarily pass through walls after collecting a pink orb.
  • 📈 Real‑time Leaderboard: Powered by Firebase Firestore — see where you rank!
  • 💾 Auto Score Submission: Logged‑in users get scores saved automatically; guests store scores locally.
  • ⏯️ Game Controls: Start, pause/resume, and reset your game easily.
  • 🔐 Secure Google Authentication: Sign in with your Google account to track personal stats.
  • 🏆 Persisted High Scores: Scores are stored in Firestore (Google users) or LocalStorage (guests).

🕹️ How to Play

  1. Use arrow keys or WASD keys to control the snake’s direction.
  2. Eat yellow food to grow and earn points.
  3. Collect pink powerups to enter Evolution Mode and pass through walls briefly.
  4. Avoid collisions with walls or your own tail (unless evolved).
  5. Use:
    • 🟢 Start to begin the game
    • ⏸️ Pause/Resume to take a break
    • 🔁 Reset to restart

Logged‑in players will have scores submitted automatically to the leaderboard.


🖼️ Screenshots

Gameplay

Snake passing through walls using the Evolution powerup.
Gameplay

Leaderboard

Top players displayed in real‑time using Firebase Firestore.
Leaderboard


🚀 Installation

  1. Clone the repository:
    git clone https://github.com/AjaysDevWorkspace/SnakeEvolution.git
    cd SnakeEvolution
    
  2. Run the game: Open index.html in any modern browser (Chrome, Firefox, Edge).

🤝 Contributing

Contributions are welcome and appreciated!

To contribute:

  1. Fork this repository.
  2. Create a new feature branch:
    git checkout -b feature/YourFeatureName
  3. Make your changes, commit, and push:
    git commit -m "Add/Improve feature"
    git push origin feature/YourFeatureName
  4. Open a Pull Request with a clear description of your changes.

Make sure your changes do not break existing features. Feature ideas, bug fixes, UI improvements, and suggestions are all welcome!

🔮 Future Improvements (Planned)

  • 🧬 Expanded evolution abilities with upgrade trees
  • 🎮 Multiple levels and increasing difficulty
  • 📱 Touch controls for mobile devices
  • 🗂️ Scores stored in backend with advanced filters (e.g. by region, time)
  • 🏟️ Multiple game arenas with dynamic hazards
  • 🎨 Customizable snake skins and themes

📬 Contact

Have questions, feedback, or want to collaborate?

📧 Ajay Sharma
✉️ [email protected]

🙏 Acknowledgments

  • 📱 Inspired by the original Nokia Snake game
  • 🔥 Powered by Firebase for real‑time backend functionality
  • 🎨 Pixel art assets from Icons8 and other open‑source resources
  • 💻 Built with 💙 using HTML, CSS, and JavaScript

Releases

No releases published

Packages

No packages published

Contributors 5