GeoPointer

A multiplayer geolocation game app combining concepts from GeoGuessr and directional pointing games. Point your device in the direction of real-world locations and compete for the highest accuracy scores.

Getting Started

1. Clone the repository
2. Setup environment variables (see below)
3. Install dependencies and start the app:

npm install
npm start     # starts the Expo development server

Environment Variables

This project uses environment variables for Firebase configuration. Create a .env file in the root directory with the following variables:

FIREBASE_API_KEY=your-api-key
FIREBASE_AUTH_DOMAIN=your-project-id.firebaseapp.com
FIREBASE_PROJECT_ID=your-project-id
FIREBASE_STORAGE_BUCKET=your-project-id.appspot.com
FIREBASE_MESSAGING_SENDER_ID=your-sender-id
FIREBASE_APP_ID=your-app-id
FIREBASE_DATABASE_URL=https://your-project-id.firebaseio.com

A .env.example file is provided as a template.

Project Structure

src/
  App.tsx               - App entry point with navigation
  navigation/           - React Navigation stack configuration
  screens/              - UI Screens (Login, Lobby, Round, Scoreboard)
  hooks/                - Custom hooks (e.g., useCompass)
  firebase.ts           - Firebase configuration and services
  env.d.ts              - TypeScript declaration for environment variables

Features

• Apple Sign-In authentication connected to Firebase
• Dynamic compass functionality that responds to device movement
• Interactive gameplay with point-to-guess mechanics
• Scoreboard for tracking accuracy
• Real-time geographic direction tracking