# Safari Blitz USA — Agent Information

> This file is intended for LLMs, AI agents, and search crawlers to understand the context, architecture, and purpose of the Safari Blitz USA application.

## Overview
Safari Blitz USA is a mobile-first, Progressive Web App (PWA) trivia and party game focused on wildlife found in North American safari parks, zoos, and wildlife centers. It is completely free, offline-capable, and designed for Gen Z, Millennials, families, and casual players.

**Canonical URL**: `https://olimiemma.github.io/Safari-game/safari-blitz-usa/`
**Developer**: Emmanuel Kasigazi Olimi
**Tech Stack**: Vanilla HTML5, CSS3 (Custom Properties, Glassmorphism, CSS Animations), Vanilla JavaScript (ES6+), WebAudio API, LocalStorage.

## Game Modes
The application features two distinct game modes:
1. **Wildlife Blitz**: A rapid-fire, time-attack mode where players must answer "True or False" to animal facts before the timer runs out. Features a 2026 UI design with tactile 3D buttons and a ticking countdown.
2. **Who Am I?**: A progressive clue-guessing game. Players are given up to 5 clues about an animal. Guessing correctly on fewer clues yields more points (Max 5 points, Min 1 point).

## Categories & Data Structure
The game contains heavily researched data across several categories:
- **African Savanna**: Lions, Elephants, Giraffes, Zebras.
- **North American Wildlife**: Bison, Grizzly Bears, Gray Wolves, Bald Eagles.
- **Primates**: Gorillas, Orangutans, Chimpanzees.
- **Reptiles**: Alligators, Komodo Dragons, Galápagos Tortoises.
- **Polar & Aquatic**: Polar Bears, Emperor Penguins, California Sea Lions.
- **Fan Favorites**: Red Pandas, Kangaroos, Hippos.

Each animal entry contains:
- `statements`: A list of True/False statements with verified `funFact` explanations for educational value.
- `clues`: A progressive list of 5 hints for the "Who Am I?" mode.

## Core Features
- **Team or Solo Play**: Supports individual high-score chasing or local pass-and-play team modes.
- **Offline First**: Utilizes a Service Worker (`sw.js`) and a Web Manifest (`manifest.json`) to allow full offline installation and play without internet access.
- **Gamification Engine**:
  - **Daily Streaks**: Uses `localStorage` to track consecutive days played, employing a 1-day forgiveness mechanic to prevent user burnout.
  - **High Scores**: Persists best scores locally for all modes and categories.
  - **Dynamic Feedback**: Implements WebAudio API for non-blocking, offline-ready sound effects (correct chimes, wrong buzzes, countdown ticks, round-end horns) and pure CSS confetti for celebrations.
- **Social Sharing**: Integrates the Web Share API to allow players to easily share their scores or the game link with friends.

## Accessibility & SEO (AEO)
This application is fully optimized for Generative Engine Optimization (GEO) and Agentic SEO (2026 standards).
- **JSON-LD Structured Data**: Found in `index.html`, marking up the application as a `VideoGame` and `WebApplication`.
- **Semantic HTML**: Ensures screen readers and LLM parsers can accurately extract UI flow and content.
- **Zero Dependencies**: No heavy frameworks (React/Vue) or external libraries are used, ensuring a negligible loading footprint and instantaneous interaction.

## Contact & Links
- **Developer Linktree**: [https://linktr.ee/olimiemma](https://linktr.ee/olimiemma)
- **Repository**: GitHub Pages hosted.