geohunt

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

(★ 15)

Geohunt -:)

geohunt Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# GeoHunt 🌍

## 📑 Table of Contents
- [Overview](#overview)
- [Features](#-features)
- [How It Works](#-how-it-works)
- [Game Flow](#-game-flow)
- [Team System](#-team-system)
- [Technical Stack](#️-technical-stack)
- [Getting Started](#-getting-started)
  - [Prerequisites](#prerequisites)
  - [Installation](#installation)
- [Key Features Explained](#-key-features-explained)
  - [Team Formation](#team-formation)
  - [Gameplay Mechanics](#gameplay-mechanics)
  - [User Experience](#user-experience)
- [Mobile Support](#-mobile-support)
- [Contributing](#-contributing)

## Overview
GeoHunt is an interactive geography game that combines exploration, learning, and team collaboration. Players can explore global landmarks and landscapes while competing individually or as part of a team.

![GeoHunt Demo](https://raw.githubusercontent.com/vishdadhich092004/geohunt/main/path/to/demo.gif)

## 🎮 Features

- **Team Play**: Create or join teams with shared usernames
- **Global Exploration**: Discover and learn about worldwide locations
- **Lives System**: Strategic gameplay with 5 lives per session
- **Collaborative Learning**: Share knowledge and strategies with team members
- **Real-time Leaderboard**: Track team progress globally

## 🔄 How It Works

```mermaid
flowchart TD
    A[Start Game] --> B{New or Existing User?}
    B -->|New| C[Create Username/Team]
    B -->|Existing| D[Login]
    C --> E[Game Session]
    D --> E
    E --> F[View Location]
    F --> G[Make Guess]
    G --> H{Correct?}
    H -->|Yes| I[Score Points]
    H -->|No| J[Lose Life]
    J --> K{Lives Left?}
    K -->|Yes| F
    K -->|No| L[Game Over]
    I --> F
```

## 🎯 Game Flow

1. **Start**: Choose between creating a new team or joining an existing one
2. **Play**: View locations and make educated guesses
3. **Score**: Earn points for correct guesses
4. **Lives**: Manage your 5 lives carefully
5. **Leaderboard**: Compare your team's performance globally

## 🤝 Team System

```mermaid
graph LR
    A[Team Creation] --> B[Shared Username]
    B --> C[Multiple Players]
    C --> D[Individual Games]
    D --> E[Shared Score Pool]
    E --> F[Global Leaderboard]
```

## 🛠️ Technical Stack

- React.js for frontend
- Tailwind CSS for styling
- Nodejs and Express for backend sever
- Used Cursor and Claude in the later stages of development

## 🚀 Getting Started

1. Clone the repository
```bash
git clone https://github.com/vishdadhich092004/geohunt.git
```

2. Install backend dependencies
```bash
cd geohunt
cd client
npm install
```
3. Install backend dependencies
```bash
cd ..
cd server
npm install
```

5. Start the backend server
```bash
cd server 
npm run dev
```
5. Start the frontend server
```bash
cd client 
npm run dev
```

## 💡 Key Features Explained

### Team Formation
- Create unique team names
- Share credentials with team members
- Collaborative score accumulation
- Real-time progress tracking

### Gameplay Mechanics
- 5 lives per session
- Strategic guessing system
- Global location database
- Interactive map interface

### User Experience
- Smooth animations
- Intuitive controls
- Responsive design
- Real-time feedback

## 📱 Mobile Support

GeoHunt is fully responsive and works seamlessly across:
- Desktop browsers
- Tablets
- Mobile devices

## 🤝 Contributing

We welcome contributions! Please feel free to submit a Pull Request.

Thanks to my friends :)

geohunt

geohunt Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

geohunt

geohunt Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README