YABA — Yet Another Bingo App

YABA is a vibrant, customizable Flutter bingo app. Play ready-made cards or create your own boards with different grid sizes, themes, emoji, artwork, and rules—then pick up exactly where you left off.

---

Tech Used

---

Features

• Ready-made bingo cards and a custom-card editor
• Configurable 3×3 to 6×6 boards, center FREE tile, tile text, border radius, and border thickness
• Real-time bingo checks for rows, columns, and diagonals
• Eight visual themes with tailored colors, backgrounds, emoji, and effects
• Keyword-based tile illustrations, custom icons, and text-only tiles
• Sound, haptic feedback, and a full-screen celebration overlay
• Saved cards, active-game progress, settings, and profile preferences via SharedPreferences
• Sort cards by recent activity, title, grid size, or completion state

---

Screenshots

  

Gameplay and themes: A playable bingo card alongside the theme and visual-background system.

---

  

Visual system: Effects and illustrations support celebratory moments and automatic tile artwork matching.

---

Project Structure

lib/
|-- main.dart               # App entry point, navigation, editor, dashboard, settings
|-- models.dart             # BingoCard model, persistence, bingo validation, starter cards
|-- theme.dart              # Theme data, color system, and eight visual themes
`-- widgets.dart            # Board, logo, previews, effects, and reusable UI

assets/images/
|-- backgrounds/            # Theme backgrounds
|-- effects/                # Celebration and UI effects
`-- logo/                   # App icon and title assets

android/ ios/ web/ windows/ macos/ linux/
                            # Flutter platform runners

---

Getting Started

Prerequisites

• Flutter SDK compatible with Dart ^3.11.5
• An Android/iOS emulator, physical device, or desktop target

Install and run

flutter pub get
flutter run

---

Development Commands

flutter analyze              # Run static analysis
flutter test                 # Run tests
flutter run                  # Run on the selected device
flutter build apk --release  # Build Android APK
flutter build appbundle      # Build Android App Bundle
flutter build web            # Build web output
flutter build windows        # Build Windows desktop app

---

Assets and Persistence

• The app bundles backgrounds, effects, and logo assets from assets/images/.
• Game state, custom boards, checked cells, settings, and profile choices are persisted locally with SharedPreferences.

---

How a Game Works

1. Pick a starter card or create a new board.
2. Select a grid size, card theme, free-space behavior, and tile appearance.
3. Tap tiles as events happen; the app evaluates rows, columns, and diagonals immediately.
4. A completed line triggers the celebration overlay and preserves current progress locally.

---

Theme System

The built-in themes cover movie night, road trip, party chaos, cozy weekend, lucky garden, ticket toss, floral fun, and soft blobs. Each theme contributes a palette, gradients, background assets, emoji accents, and interface treatments via theme.dart.

---

Local Data

• Active boards and checked cells are saved so a game can resume after relaunching.
• Custom cards are serialized through the BingoCard model in models.dart.
• User profile, sound, haptic, and sorting preferences are stored locally.
• No remote account or backend is required for the core play and card-creation experience.