# Londle - London Boroughs Quiz Game

> An interactive geography quiz game testing knowledge of London's 32 boroughs and City of London

## Site Information

- Name: Londle
- URL: https://londle.uk
- Type: Educational Geography Quiz Game
- Language: English (British)
- Target Audience: Geography enthusiasts, London residents, students, tourists

## Purpose

Londle is a free educational game where players test their knowledge of London geography by locating all 32 London boroughs plus the City of London on an interactive map. The game features multiple difficulty levels, timed challenges, and a competitive leaderboard system.

## Key Features

### Game Modes
- **Easy Mode**: Includes directional hints (North, South, East, West London) to help locate boroughs
- **Normal Mode**: Standard difficulty with directional hints
- **Hard Mode**: No hints provided - pure geographic knowledge test
- **Timer Challenge**: Optional timer for competitive scoring

### Scoring System
- Points awarded for correct borough identification
- Bonus points for faster completion times
- Difficulty multipliers: Easy (1x), Normal (1.5x), Hard (2x)
- Time bonus calculation: Higher scores for faster completion

### Leaderboard
- Global leaderboard with player rankings
- Displays player score, time taken, difficulty level, and date
- Sortable by score, time, and difficulty
- International player participation with flag display

### Game Mechanics
- Interactive SVG map of London
- Tap-to-select, tap-again-to-confirm system
- Visual feedback with color-coded boroughs:
  - Grey: Unguessed boroughs
  - Highlighted: Selected borough
  - Green: Correctly guessed boroughs
- 3 "reveal" tokens per game (London Guard icons)
- Skip functionality to return to difficult boroughs later
- Zoom and pan controls for detailed map exploration

## Technical Details

- Built with React, TypeScript, Vite, and Tailwind CSS
- Uses TopoJSON data from UK GeoJSON project
- Real-time leaderboard powered by Supabase
- Responsive design for mobile and desktop
- SEO optimized with structured data

## Educational Value

Londle helps users:
- Learn the names and locations of all London boroughs
- Understand London's geographic layout
- Differentiate between the 32 boroughs and the City of London (which is technically not a borough)
- Improve spatial memory and geographic knowledge

## Pages

### / (Homepage/Game)
The main game interface where players locate London boroughs on an interactive map.

**Key Elements:**
- Interactive London map with 33 clickable regions
- Target borough display with optional directional hints
- Game statistics (score, progress, time)
- Difficulty selector
- Zoom/pan controls for map navigation
- Three London Guard reveal tokens

### /leaderboard
Global leaderboard showing top players' scores, times, and achievements.

**Key Elements:**
- Ranked list of players with scores, flags, and timestamps
- Filter and sort options (by score, time, difficulty)
- Player statistics and completion times
- Example scoring calculations
- Link to view daily winner

### /winner/[date] (Format: YYYY-MM-DD)
Daily winner celebration pages showcasing the top scorer for each date.

**Key Elements:**
- Winner's name, flag, score, and performance stats
- Daily game statistics (total games, average score, fastest time)
- Difficulty distribution breakdown
- Perfect score count
- Average completion times by difficulty level
- Call-to-action to play the game
- Structured data for SEO and social sharing
- Optimized for Google Discover with rich content

**Example URLs:**
- /winner/2025-01-15
- /winner/2025-01-20
- Current day automatically accessible from leaderboard

## London Borough Information

The game covers all 33 administrative divisions of Greater London:
- 32 London Boroughs (established by the London Government Act 1963)
- City of London (the historic square mile, not technically a borough)

**The 32 Boroughs:**
Barking and Dagenham, Barnet, Bexley, Brent, Bromley, Camden, Croydon, Ealing, Enfield, Greenwich, Hackney, Hammersmith and Fulham, Haringey, Harrow, Havering, Hillingdon, Hounslow, Islington, Kensington and Chelsea, Kingston upon Thames, Lambeth, Lewisham, Merton, Newham, Redbridge, Richmond upon Thames, Southwark, Sutton, Tower Hamlets, Waltham Forest, Wandsworth, Westminster

**Plus:** City of London

## Contact & Social

- Type: Educational game project
- Analytics: Google Analytics tracking enabled
- Shareable results for social media

## Schema

The site uses Game schema markup (schema.org/Game) for better search engine understanding, with aggregate ratings and geographic focus on London, United Kingdom.