https://github.com/cod-e-codes/partydice
A Flutter-powered interactive game designed for parties and group activities. PartyDice features customizable player profiles, turn-based challenges, engaging animations, and an in-app store to elevate your party experience.
https://github.com/cod-e-codes/partydice
dice-game flutter group-activities mobile-app party-game
Last synced: 10 months ago
JSON representation
A Flutter-powered interactive game designed for parties and group activities. PartyDice features customizable player profiles, turn-based challenges, engaging animations, and an in-app store to elevate your party experience.
- Host: GitHub
- URL: https://github.com/cod-e-codes/partydice
- Owner: Cod-e-Codes
- Created: 2024-11-25T23:23:23.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-26T00:13:21.000Z (about 1 year ago)
- Last Synced: 2025-01-04T20:42:36.803Z (12 months ago)
- Topics: dice-game, flutter, group-activities, mobile-app, party-game
- Language: Dart
- Homepage: https://github.com/Cod-e-Codes/PartyDice
- Size: 32.3 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# PartyDice ๐ฒ
PartyDice is a fun and interactive game designed for parties and group activities. Built with Flutter, this app provides exciting gameplay, engaging animations, and a store to enhance your experience.
## Screenshots ๐ธ
1. **Login Screen**
2. **PartyDice Screen**
3. **Player Setup**
4. **Help Screen**
5. **Gameplay Screen (Player 1)**
6. **Gameplay Screen (Player 2)**
## Features โจ
- **User Authentication**: Login and signup features to create and save player profiles.
- **Customizable Gameplay**: Players can add, edit, and remove their profiles before starting a game.
- **Turn-based Fun**: Each player takes turns performing tasks or challenges assigned by the dice rolls.
- **Roll History**: Keeps track of the tasks and challenges completed during gameplay.
- **In-App Store**: Purchase additional features or themes to enhance the game (not shown in screenshots).
- **Dynamic Animations**: Engaging animations for smooth transitions between screens and actions.
## File Structure ๐
```plaintext
lib/
โโโ firebase_options.dart # Firebase configuration options
โโโ main.dart # Application entry point
โโโ models/
โ โโโ player.dart # Player data model
โโโ screens/
โ โโโ gameplay_screen.dart # Core gameplay functionality
โ โโโ login_screen.dart # User login interface
โ โโโ party_dice_screen.dart # Player setup and gameplay preparation
โ โโโ store_screen.dart # In-app store interface
โโโ widgets/
โ โโโ animated_button.dart # Custom animated button widget
โ โโโ gender_selection.dart # Gender selection widget
โ โโโ player_card.dart # Player card widget
```
## How to Play ๐ฎ
1. **Login/Sign Up**: Create or log in to your account.
2. **Add Players**: Select a gender, enter a name, and add at least two players to start the game.
3. **Start Game**: Begin the gameplay and follow the instructions for your turn.
4. **Track Progress**: View the roll history to see completed challenges.
5. **Explore the Store**: Enhance your experience by purchasing additional features.
## Getting Started ๐
### Prerequisites
- Install [Flutter](https://flutter.dev/docs/get-started/install) on your system.
### Installation
1. Clone the repository:
```bash
git clone https://github.com/cod-e-codes/PartyDice.git
```
2. Navigate to the project directory:
```bash
cd PartyDice
```
3. Install dependencies:
```bash
flutter pub get
```
4. Run the app:
```bash
flutter run
```
### Firebase Setup
Ensure to configure Firebase in your project using the provided `firebase_options.dart` file.
## Author ๐๏ธ
This app was developed by **CodฤCodes**. Check out more of my projects on [GitHub](https://github.com/cod-e-codes).
---
Have fun and enjoy the PartyDice experience!