ncsuguessr

ncsuguessr is a North Carolina State University-themed geography game inspired by GeoGuessr. Test your knowledge of the NC State campus as you guess locations based on images and landmarks.

Features

• Explore and guess iconic NC State landmarks.
• Test your knowledge of the campus layout.
• Contribute photos to be featured in future puzzles.

Game Rules

• Each day, you'll be shown a random location from the NC State campus.
• Guess the correct location by placing a marker on the map.
• Earn points based on accuracy—the closer your guess, the higher your score.

Prerequisites

Before you begin developing, ensure you have the following installed:

• Visual Studio Code
• Node.js
• Expo Go (on your phone)
• Prettier (VSCode Extension)
• Tailwind CSS Intellisense (VSCode Extension)
• nvm
  • Windows
  • MacOS

Optional VSCode Extensions:

• vscode-icons
• vscode-pets

Setup

1. Clone the repository:

   git clone https://github.com/NCSU-App-Development-Club/ncsuguessr.git
   cd ncsuguessr
   cd mobile # enter the directory with the mobile app

2. Install and use Node.js version 22.9.0 with nvm:

   nvm install

   If you ever change Node.js versions for a different project, be sure to run nvm use from the project root to switch back to this project's Node.js version (22.9.0).

3. Install the necessary node modules:

   npm install

4. Start the application:

   npm run start
   

5. Scan the QR code in the terminal with your phone.

Contribution - App Development Club Members Only

Important note: if network requests fail on an iPhone emulator with iOS 18.4, try downgrading to iOS 18.3: expo/expo#36136

You and your small group will be assigned issues to work on as a team. For each issue, do the following:

1. Create a new branch from the development branch:

   git checkout development
   git checkout -b <feature-branch-name>

2. Push your new branch:

   git push --set-upstream origin <feature-branch-name>

3. Work on your new branch as usual.
4. When your branch is ready for review, open a Pull Request.

---

Wolfpack up and test your campus knowledge with ncsuguessr! Go Pack!

Misc

npm install @tailwindcss/oxide-linux-x64-gnu lightningcss-linux-x64-gnu && npm install && npm run build-web && mv dist/assets/node_modules/* dist/assets/ && find dist/_expo/static/js/web/ -type f -print0 | xargs -0 sed -i 's/assets\/node_modules/assets/g'