> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/igorek05m/daily-geogame/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Welcome to Daily GeoGame - a daily geography guessing game that challenges you to identify countries using progressive hints and an interactive map

# Welcome to Daily GeoGame

Daily GeoGame is a simple, daily geography guessing game inspired by Wordle, Travle, and Globle. Every day at midnight UTC, a new country is selected, and you have 6 attempts to guess it using progressive hints from the CIA World Factbook.

<CardGroup cols={2}>
  <Card title="Quick start" icon="rocket" href="/quickstart">
    Get started with your first game in minutes
  </Card>

  <Card title="How to play" icon="map" href="/gameplay/how-to-play">
    Learn the game mechanics and strategies
  </Card>

  <Card title="Features" icon="star" href="/features/daily-challenge">
    Explore all the game features and capabilities
  </Card>

  <Card title="Statistics" icon="chart-bar" href="/features/statistics">
    Track your progress and compare with others
  </Card>
</CardGroup>

## What is Daily GeoGame?

Daily GeoGame is a web-based geography game where you identify a mystery country each day. With each guess, you unlock new hints about climate, terrain, GDP, and more. An interactive SVG map helps you visualize your guesses with distance and direction feedback.

<Note>
  No login required! Your statistics are saved locally and synced anonymously via a session ID.
</Note>

## Key features

<CardGroup cols={2}>
  <Card title="Daily challenge" icon="calendar">
    A new country is selected every day at midnight UTC. Everyone plays the same challenge.
  </Card>

  <Card title="6 progressive hints" icon="lightbulb">
    Unlock hints about climate, terrain, GDP, population, and more from the CIA World Factbook with each guess.
  </Card>

  <Card title="Interactive map" icon="globe">
    Zoom and pan on an SVG world map that highlights your guesses, neighboring countries, and regional connections.
  </Card>

  <Card title="Distance & direction" icon="compass">
    Get real-time feedback showing the distance (in km) and bearing to the target country from your guesses.
  </Card>

  <Card title="Session-based tracking" icon="database">
    Your progress is automatically saved and synced without requiring an account or login.
  </Card>

  <Card title="Global statistics" icon="users">
    View leaderboards and compare your performance with players worldwide after completing each game.
  </Card>
</CardGroup>

## Try it live

Ready to test your geography knowledge? Play the game now:

<Card title="Play Daily GeoGame" icon="play" href="https://daily-geogame.vercel.app">
  Start your daily geography challenge
</Card>

## What makes it fun?

* **Progressive difficulty**: Start with basic hints and unlock more specific clues as you make guesses
* **Visual feedback**: See your guesses highlighted on the map with color-coded proximity indicators
* **Learning experience**: Discover new facts about countries from the CIA World Factbook
* **Daily ritual**: A fresh challenge every day keeps you coming back
* **No pressure**: 6 attempts give you room to explore and learn

## How it works

The game follows a simple flow:

1. Visit the site to see today's challenge number and the interactive map
2. Make your first guess from any of the 195+ countries
3. Receive distance/direction feedback and unlock your first hint
4. Use the hints and map to narrow down your next guesses
5. Win by guessing correctly within 6 attempts
6. View your statistics and compare with global players

<Tip>
  The hints unlock progressively, so each guess gives you more information. Use them strategically!
</Tip>

## Built with modern tech

Daily GeoGame is built using:

* **Next.js 15** with App Router for server-side rendering
* **React 19** for interactive UI components
* **TypeScript** for type-safe development
* **MongoDB Atlas** for game state and statistics
* **RestCountries API** for comprehensive country data
* **CIA World Factbook** for detailed geographic hints

## Get started

Ready to play? Head over to the [Quick start guide](/quickstart) to learn the basics and start your first game.