Flappy Bird

A clone of the popular Flappy Bird game built using the Flame Engine. This project showcases the capabilities of the Flame game engine and Flutter for building 2D games that work seamlessly across multiple platforms.

Features

• Smooth gameplay inspired by the original Flappy Bird
• Cross-platform support: Android, iOS, Web, Windows, macOS, and Linux
• Built using Flame, a lightweight 2D game engine for Flutter
• Highly customizable and extendable codebase

Demo

Here is a short video recording of the game running on iOS:

Simulator.Screen.Recording.-.iPhone.16.Pro.-.2024-12-16.at.00.08.22.mp4

Getting Started

Prerequisites

Make sure you have the following installed on your system:

• Flutter
• A compatible IDE like Visual Studio Code or Android Studio

Cloning the Repository

To get started, clone this repository to your local machine:

# Clone the repository
git clone https://github.com/alex1kariuki/flappy_bird.git

# Navigate into the project directory
cd flappy-bird

Running the Project

The following steps show how to run the project on various platforms.

1. Running on Web (Chrome)

flutter run -d chrome

2. Running on Windows

Ensure you have set up Flutter for Windows development:

flutter run -d windows

3. Running on macOS

Ensure you have Xcode installed and set up Flutter for macOS development:

flutter run -d macos

4. Running on Linux

Ensure you have set up Flutter for Linux development:

flutter run -d linux

5. Running on iOS

Ensure you have Xcode installed and an iOS simulator or a physical device connected:

flutter run -d ios

Note: You might need a Mac with Xcode installed to build and run on iOS.

6. Running on Android

Ensure you have Android Studio installed with an emulator or a physical device connected:

flutter run -d android

Contributing

Contributions are welcome! If you find any bugs or have feature requests, feel free to open an issue or submit a pull request.

Steps to Contribute

1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Commit your changes and push them to your fork.
4. Submit a pull request.

License

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

Acknowledgments

• Inspired by the original Flappy Bird game.
• Built with the amazing Flame Engine.

---

Happy coding! 🎮