Yaygara is a vibrant, mobile-first, and offline-ready party game based on narration and guessing. It brings people together for fast-paced fun, blending the best elements of classic games like Taboo and Charades.
It can be used directly through a browser or as an APK file on Android devices.
Live: yaygara.mertskaplan.com
- Unlimited Decks with Master Prompt: Create custom word decks instantly using a specialized AI prompt.
- Mobile-First Design: Optimized for a seamless experience on smartphones and tablets.
- PWA Support: Installable as a native-like app on your home screen.
- Audio Feedback: Immersive sound effects for correct answers, passes, and timer alerts.
- Customizable Game Rules: Set the number of teams, turn duration, and word count per game.
- Team Customization: Choose your own team names and vibrant colors.
- Multi-language Support: Play in English or Turkish.
- Offline Capable: Works perfectly without an internet connection once loaded.
- Ready-to-Play Decks: Comes with numerous built-in word decks across various categories.
- Auto-Pause: The game automatically pauses if you switch tabs or leave the app.
- Frontend: React + TypeScript + Vite
- Styling: Tailwind CSS + Shadcn UI
- State Management: Zustand (with Persistence & Immer)
- Animations: Framer Motion
- Icons: Lucide React
- Runtime: Bun
You can run Yaygara directly from Docker Hub with a single command:
docker run -d -p 8727:80 mertskaplan/yaygaraCreate a docker-compose.yml file with the following content:
version: '3.8'
services:
yaygara:
image: mertskaplan/yaygara:latest
container_name: yaygara
ports:
- "8727:80"
restart: unless-stoppedThen run:
docker-compose up -d-
Clone the repository:
git clone https://github.com/mertskaplan/yaygara.git cd yaygara -
Install dependencies:
bun install
-
Start the development server:
bun run dev
Yaygara includes an optional telemetry system to help improve game balance and deck quality.
- Disabled by Default: Telemetry is completely inactive unless explicitly enabled.
- Automatic: When enabled, game data is sent automatically at the end of every completed game, without asking the players. The About dialog tells players that this server collects telemetry.
- Anonymous Data: Only game-related data (such as played deck, game duration, number of passes, and team scores) is collected. Team names or any other personal data are never sent, and the data is not linked to personal data.
To use telemetry, you must also set up the Yaygara Telemetry software.
Add these environment variables to your docker-compose.yml file:
environment:
- TELEMETRY_ENABLED=true
- TELEMETRY_URL=https://lab.mertskaplan.com/yaygara-telemetry/apiRun the project with the environment variables:
VITE_TELEMETRY_ENABLED=true VITE_TELEMETRY_URL=https://lab.mertskaplan.com/yaygara-telemetry/api bun run devYou can visit lab.mertskaplan.com/yaygara-telemetry/ (or test mode) to see the telemetry data for the main Yaygara repository. The API address will not accept data from your server. Therefore, you need to set up your own telemetry service and configure the address accordingly.
You can inject any script (e.g. an analytics/visitor counter snippet) into the <head> of every page with the HEADER_JS environment variable. It is empty by default.
environment:
- 'HEADER_JS=<script defer src="https://example.com/script.js" data-website-id="your-id"></script>'If Umami, Google Analytics (gtag) or Yandex Metrica is loaded through HEADER_JS, Yaygara sends the following events to every tool found on the page. Nothing is sent if none is loaded. For Yandex Metrica, also set YM_COUNTER_ID to your counter number (events are sent as goals with reachGoal).
| Event | When | Properties |
|---|---|---|
game_start |
A game starts | language, deck_id, deck_difficulty, custom_deck, team_count, word_count, turn_duration |
game_complete |
A game ends after round 3 | same as game_start + winner_team (1-based team position, or tie), duration_min |
game_abandon |
A game is quit mid-way | same as game_start + round |
pwa_install |
The app is installed | β |
AI-generated custom decks are reported with deck_id as custom. Team names are never sent.
environment:
- YM_COUNTER_ID=12345678src/components/: Reusable UI components and modals.src/pages/: Main application screens (Home, Setup, Game, Score).src/stores/: Game state management using Zustand.src/lib/: Utilities for sound, deck fetching, and helper functions.src/hooks/: Custom React hooks for translations and logic.public/decks/: JSON files containing the word decks.prompts/: Specialized prompts for AI deck generation.
βββ π prompts
βββ π public
β βββ π decks
β βββ π icons
β βββ π locales
βββ π src
β βββ π assets
β βββ π components
β β βββ π ui
β βββ π hooks
β βββ π lib
β βββ π pages
β βββ π stores
β βββ π typesTo add a new word deck to the game:
-
Create a JSON file in
public/decks/following this structure:{ "id": "my-cool-deck.en", "name": "My Cool Deck", "language": "en", "difficulty": "medium", "words": [ { "term": "Example", "hint": "A short clue", "difficulty": 1 } ] } -
Add the filename (e.g.,
"my-cool-deck.en.json") to the array inpublic/decks-manifest.json.
Yaygara is free software, and its source code is licensed under the GNU General Public License v3.0 (GPLv3), while its game content and assets are licensed under Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0).
Built with β€οΈ by Mert S. Kaplan.
Free software projects like Yaygara have infrastructure and sustainability costs. To ensure similar projects can be developed ad-free and available to everyone, you can provide support via Kreosus.





