🎲 DORAK - دورك

A Family Party Game Inspired by Seen Jeem

"A game that brings together family and friends"

---

📱 About DORAK

DORAK is a family-oriented interactive mobile game designed to bring laughter, connection, and competition across all ages. Players form two teams and compete through trivia questions, physical challenges, and strategic power cards.

Key Features

• 🎮 2-20 Players - Individual or team gameplay
• 🌍 Bilingual - Full English & Arabic support
• 🏆 Smart Scoring - Difficulty-based points with bonuses
• 🎁 Jackpot Mode - High-risk, high-reward questions
• ⚡ Power Cards - Game-changing abilities
• 💪 Physical Challenges - Fun action-based tasks
• 📊 Match History - Track and review past games
• 🎨 Kuwaiti Theme - Red, Green, Black, White colors

---

🎯 How to Play

1. Create or Join Room

• Host: Create a new room (gets 6-character code)
• Players: Join using room code
• Teams: Choose Team A (Red) or Team B (Green)

2. Select Categories

• Choose 5-8 categories
• Set difficulty (Easy/Medium/Hard or All)
• Set number of questions (5-20)

3. Play the Game

• Teams vote on answers (60 seconds per question)
• Majority wins - Most voted answer counts
• Host controls - Timer, points, approvals
• Power cards - Strategic gameplay changers

4. Win!

• Team with highest score wins
• View match history
• Play again!

---

⭐ Scoring System

Difficulty-Based Points

Difficulty	Points	Penalty (Wrong)
Easy 🟢	100 pts	-100 pts
Medium 🟠	250 pts	-150 pts
Hard 🔴	400 pts	-200 pts

Bonuses

• 🔥 Streak Bonus: +200 pts (3 correct answers in a row)
• ⚡ Speed Bonus: +150 pts (vote in < 10 seconds)
• 🎁 Jackpot: 200-600 pts (high risk/reward)

Power Cards

• 💎 Double Points - Multiply all scoring by 2x
• 💰 Steal Points - Take 2 points from other team
• 🔄 Reverse Turn - Change question to other team
• ⏭️ Skip Round - Move to next question

---

🚀 Installation

For Players (Android)

Option 1: APK File

1. Download app-release.apk
2. Enable "Install from unknown sources"
3. Tap APK to install
4. Open DORAK app

Option 2: Google Play Store (Coming soon)

For Developers

# Clone repository
git clone <repository-url>
cd DORAK

# Install dependencies
flutter pub get

# Run on device/emulator
flutter run

# Build APK
flutter build apk --release

---

🛠️ Technical Stack

Frontend

• Framework: Flutter 3.35.4
• Language: Dart
• State Management: Provider
• UI: Material Design

Backend

• Database: Firebase Firestore
• Authentication: Firebase Auth
• Storage: Firebase Storage (future)
• Hosting: Firebase Hosting (web version)

Features & Packages

• firebase_core - Firebase integration
• cloud_firestore - Real-time database
• firebase_auth - Authentication
• google_sign_in - Google login
• sign_in_with_apple - Apple login
• sensors_plus - Motion detection
• audioplayers - Audio playback
• share_plus - Room code sharing
• intl - Internationalization

---

📂 Project Structure

DORAK/
├── lib/
│   ├── models/          # Data models
│   ├── screens/         # UI screens
│   ├── services/        # Business logic
│   ├── widgets/         # Reusable components
│   ├── utils/           # Utilities & constants
│   ├── l10n/            # Localization files
│   └── main.dart        # App entry point
├── assets/
│   ├── images/          # Images & icons
│   └── audio/           # Sound files
├── android/             # Android config
├── ios/                 # iOS config
└── firebase/            # Firebase config

---

🎮 Game Modes

1. Trivia Questions

• Multiple choice answers
• Team voting system
• Difficulty levels
• Category-based

2. Physical Challenges

• Verbal tasks
• Motion-based (shake/tilt)
• Host approval required
• Bonus points

3. Karaoke Mode (Coming Soon)

• Audio clip playback
• Song recognition
• Team performance

---

👥 User Roles

Host

• Creates room
• Controls timer
• Starts voting
• Reveals answers
• Awards points manually
• Approves physical challenges
• Toggles jackpot mode
• Uses power cards
• Ends game

Players

• Join with room code
• Select team
• Vote on answers
• See real-time scores
• Chat with team
• View match history

---

🔐 Authentication

Supported Methods

1. Guest - Quick anonymous login
2. Google - Sign in with Google account
3. Apple - Sign in with Apple ID

Privacy

• No personal data collected for guests
• Social login only stores name & email
• All data encrypted in Firebase
• GDPR compliant

---

📊 Admin Dashboard

Features (For Game Owner)

• Manage questions
• Edit categories
• View analytics
• Monitor active rooms
• Manage users

Access

• Email: [email protected]
• Full admin privileges

---

🌐 Localization

Supported Languages

• 🇬🇧 English (EN)
• 🇸🇦 Arabic (AR)

RTL Support

• Automatic layout direction
• Localized strings
• Culture-appropriate UI

---

🧪 Testing

Requirements

• 2+ Android devices (for multiplayer test)
• Internet connection
• Android 6.0+ (API 23+)

Test Scenarios

1. Single Player: Create room, test basic flow
2. Multiplayer: 2-4 players, full game
3. Scoring: Verify all bonuses & penalties
4. Power Cards: Test each card type
5. Match History: Check saves & displays

---

📦 Build & Deploy

Android APK

Debug Build:

flutter build apk --debug
# Output: build/app/outputs/flutter-apk/app-debug.apk

Release Build:

flutter build apk --release
# Output: build/app/outputs/flutter-apk/app-release.apk (77.5MB)

iOS (Requires macOS)

flutter build ios --release

---

🐛 Known Issues & Limitations

v1.0 Limitations

• Physical sensors require real device (not emulator)
• Karaoke audio files not included (placeholder ready)
• iOS build requires macOS environment

Future Enhancements (Phase 2)

• OpenTrivia DB integration (1000+ questions)
• Auto-translation API
• Video clips for movie questions
• Advanced analytics
• Dual-host system
• Family leaderboard

---

📝 Changelog

v1.0.0 (November 19, 2025) - Initial Release

• ✅ Core game loop (lobby → game → results)
• ✅ Difficulty-based scoring (100/250/400)
• ✅ Bonus system (streak, speed, jackpot)
• ✅ Power cards (4 types)
• ✅ Match history
• ✅ Question anti-repetition
• ✅ Physical challenge approval
• ✅ Bilingual support (EN/AR)
• ✅ 400+ default questions
• ✅ 8 categories
• ✅ Chat system
• ✅ Real-time multiplayer sync

---

👨‍💻 Development

Team

• Owner: Jassim Alsayrafi
• Email: [email protected]
• Development: 10-day sprint (Nov 9-19, 2025)

Development Timeline

• Days 1-2: Scoring system
• Days 3-4: Match history & anti-repetition
• Days 5-6: Sensors, audio, UI polish
• Days 7-8: Testing & bug fixes
• Days 9-10: Build & launch

---

📄 License

© 2025 Jassim Alsayrafi. All rights reserved.

---

🤝 Support

Issues & Bug Reports

Contact: [email protected]

Feature Requests

We're actively developing! Send feedback for future updates.

---

🎉 Credits

Inspired by: Seen Jeem, Goalobha, Makhmikh

Special Thanks:

• Flutter team for amazing framework
• Firebase for backend infrastructure
• Gulf culture for design inspiration

---

📱 Download

Android APK: Available in build/app/outputs/flutter-apk/

• app-debug.apk - For testing
• app-release.apk - For distribution

Google Play Store: Coming soon App Store (iOS): Coming soon

---

🎮 Let's Play!

DORAK brings families and friends together through fun, competition, and laughter.

Download now and start your family game night! 🎲

---

Made with ❤️ in Kuwait 🇰🇼