Skip to content

Adam-Diaa/Ghamza

Repository files navigation

📖 About

Ghamza (meaning "wink" in Arabic) is a digital version of the classic party game where one player is secretly chosen as the "killer" who eliminates other players by winking at them, while the remaining players try to identify the killer before everyone is eliminated. This mobile app eliminates the need for physical cards and makes the game setup quick and easy. Perfect for parties, family gatherings, and friend meetups!

🌟 Why Ghamza?

✅ No Physical Cards Needed - Everything runs on one device

✅ Bilingual Support - Switch between Arabic and English seamlessly

✅ Completely Offline - No internet connection required

✅ No Ads - Pure gaming experience

✅ Free & Open Source - Forever free for everyone

✅ Lightweight - Small app size, runs smoothly on any device

✨ Features

🎮 Core Gameplay

.Random Number Distribution - Each player gets a unique secret number

.Random Killer Selection - The killer is chosen randomly every game

.Visual Feedback - Killer's number appears in red with 🎯 emoji

.Swipe Gesture - Swipe up to reveal your secret number

.Privacy Protection - Screen changes between players to prevent peeking

🌐 Localization

.Arabic Interface - Full RTL support

.English Interface - Complete translation

.Real-time Language Switching - Change language anytime with one tap

📱 User Experience

.Clean UI - Modern, intuitive Material Design

.How to Play Guide - Built-in step-by-step tutorial

.Game in Progress Screen - Clear indication when game is active

.Player Management - Easy add/remove players interface

.Unlimited Players - Support for any group size (minimum 2)

🚀 Installation

For Users

.Download APK

.Go to Releases

.Download the latest app-release.apk

.Install on your Android device

.Enjoy the game!

Google Play Store

.Coming soon! 🎉

For Developers

Prerequisites

.Flutter SDK (3.0 or higher)

.Android Studio or VS Code

.Android device or emulator

Setup

bash# Clone the repository

git clone https://github.com/Adam-Diaa/Ghamza.git

cd ghamza_game

Install dependencies

flutter pub get

Run the app

flutter run

Build APK

bash# Build release APK

flutter build apk --release

Build split APKs (smaller size)

flutter build apk --split-per-abi --release

Build App Bundle (for Play Store)

flutter build appbundle --release

🎯 How to Play

Setup (1 minute)

.Add Players - Enter names of all players (minimum 2)

.Start Game - Tap "Done" when ready

.View Numbers - Each player swipes up to see their secret number privately

.Begin Playing - After the last player, tap "Start"

..Game Rules..

The Killer 🎯

.One player receives the killer number (shown in red with 🎯)

.The killer eliminates players by winking at them

.When a player is winked at, they must announce their elimination after a few seconds

.The killer wins if only 2 players remain

Other Players 👥

.Try to identify the killer by observing who's winking

.When you think you know the killer, call them out

.If correct, the killer is eliminated and players win

.If wrong, you're eliminated

Tips for Best Experience

💡 Play with 4+ players for more fun

🤫 Don't show your number to others

⏱️ Wait a few seconds after being winked at before announcing

🎭 The killer should be subtle with their winks!

👨‍💻 Author

Adam Diaa Eldin Mohammed

GitHub: @Adam-Diaa

Email: adamghonaim1@gmail.com

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors