vibegames

VibeGames - A Modern Flutter Gaming Hub

VibeGames is a sleek and modern Flutter application that serves as a central hub for a variety of web-based games. Built with a focus on clean architecture and a great user experience, it features dynamic content, game categories, and integrated advertising with Google AdMob.

📸 Screenshots

(Here you can add screenshots of your app. For example:)

Home Screen	Category Page
IMAGE_PLACEHOLDER	IMAGE_PLACEHOLDER

✨ Features

• Dynamic Home Screen: Displays games in various sections like a hero slider, top 10 ranked games, and popular games.
• Game Categories: Browse games by category.
• Continue Playing: Quickly jump back into recently played games.
• WebView for Games: Seamlessly play web-based games within the app.
• Google AdMob Integration:
  • App Open Ads: Displayed when the app is brought to the foreground.
  • Interstitial Ads: Shown after a certain number of game plays.
  • Banner Ads: Displayed on the home screen.
• State Management: Powered by Riverpod for efficient and scalable state management.
• Clean Architecture: Organized code into features, services, and core components.

🛠️ Technologies & Packages Used

• Flutter: The UI toolkit for building beautiful, natively compiled applications.
• Riverpod: State management.
• GoRouter: Navigation.
• Google Mobile Ads: For ad integration.
• Firebase: For backend services.
• CachedNetworkImage: For loading and caching network images.
• WebView Flutter: For displaying web content.

🚀 Getting Started

To get a local copy up and running, follow these simple steps.

Prerequisites

• Flutter SDK (version 3.x or higher)
• An editor like VS Code or Android Studio
• An Android Emulator or a physical device

Installation

1. Clone the repo

   git clone https://github.com/your_username/vibegames.git
   

2. Navigate to the project directory

   cd vibegames
   

3. Install packages

   flutter pub get
   

4. Run the app

   flutter run