Skip to content

vinicius-saraiva/flappy-chouette

Repository files navigation

🦉 Flappy Owl Game

A modern web-based implementation of the classic Flappy Bird game, featuring a charming owl theme and competitive leaderboard system. Play now at flappychouette.fun!

🎮 Game Features

  • Authentic Gameplay: Classic side-scrolling mechanics with a unique owl twist
  • Responsive Design: Playable on both desktop and mobile devices
  • Real-time Leaderboard: Compete with other players for the top spot
  • Secure Authentication: Login system powered by Auth0
  • Score Tracking: Personal best scores and global rankings
  • Countdown Timer: Special event timing system

🛠️ Technologies Used

  • Frontend: HTML5, CSS3, JavaScript
  • Game Engine: Phaser.js
  • Authentication: Auth0
  • Database: Supabase
  • Hosting: GitHub Pages

🔐 Security Features

  • Secure user authentication via Auth0
  • Protected game access for authenticated users only
  • Public leaderboard viewing for all visitors
  • Secure score submission system

🎯 How to Play

  1. Visit flappychouette.fun
  2. Login with your preferred method
  3. Click "Start Game"
  4. Tap/click to make the owl flap
  5. Avoid the pipes and collect points
  6. Compare your score on the leaderboard

🚀 Local Development

  1. Clone the repository: bash python -m http.server 3000

  2. Visit http://localhost:3000 in your browser

📝 Configuration

To run your own instance, you'll need to:

  1. Set up an Auth0 application
  2. Create a Supabase project
  3. Update the configuration variables in the code
  4. Configure allowed origins in both services

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📜 License

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

🙏 Acknowledgments

  • Original Flappy Bird game concept by Dong Nguyen
  • https://github.com/chaping/flappy-bird for the entire game I used as a base
  • Phaser.js game framework
  • Auth0 for authentication
  • Supabase for database services

🎨 Assets

Game assets and artwork are custom-made for this project.


About

The most mythical version of flappy games.

Resources

Stars

Watchers

Forks

Packages

No packages published