Skip to content

Latest commit

ย 

History

History
163 lines (82 loc) ยท 3.33 KB

File metadata and controls

163 lines (82 loc) ยท 3.33 KB

๐Ÿ“– 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