/worldguessr

Free & Open source version of Geoguessr

Primary LanguageJavaScriptMIT LicenseMIT

WorldGuessr

A free and open-source version of the popular geography game inspired by GeoGuessr. This project is built with Next.js and aims to provide a fun and educational way to explore the world through random street views.

Play now here!

Features

  • Random Street Views: Experience a new location anywhere in the world on each game.
  • Multiplayer Mode: Challenge your friends or play against random opponents in real-time.
  • Country Streaks: Test your knowledge and see how many countries you can guess in a row.
  • Free to run: The project is open-source and free to run on your own server. Uses the Google Maps Streetview Embed API, which is completely free compared to the costly SDK used by GeoGuessr.

Acknowledgements

Running Locally

Prerequisites

Before you start, ensure you have the following installed:

Installation

  1. Clone the repository:

    git clone https://github.com/codergautam/worldguessr.git
    cd worldguessr
  2. Install dependencies:

    pnpm install
  3. Run the development server:

    pnpm run dev

    Open http://localhost:3000 with your browser to see the result.

Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the MIT License. You are free to use, modify, and distribute this project for personal or commercial use. See LICENSE.md for more information.

Community

Join the Discord community here to discuss new features, report bugs, talk to the developers and connect with other players.

You can email me privately at gautam@codergautam.dev