Skip to content

PheanoukHun/FindUT

Repository files navigation

FindUT 🤘

FindUT is a scavenger hunt application built for the University of Texas community. It allows users to post visual challenges of locations or landmarks, which others must then physically find and verify by capturing and uploading their own matching photos.

The application uses AI-powered image verification to ensure that the photos uploaded by users match the original challenge location.

🌟 Features

  • 📍 Challenge Discovery: Browse a variety of location-based challenges posted by the community.
  • 📸 AI Verification: Submit a photo of your find, and our OpenAI-powered verification system will confirm if it matches the original location.
  • 🏆 Leaderboard: Earn "Honks" for every successful verification and climb the ranks of the FindUT leaderboard.
  • 🏠 User Authentication: Secure sign-in using Firebase Authentication to track your progress and challenges.
  • 🗺️ Location Hints: Each challenge comes with a helpful hint to guide your search.

🛠️ Tech Stack

  • Frontend: React, TypeScript, Vite
  • UI Framework: Chakra UI
  • Animations: Framer Motion
  • Backend/Database: Firebase (Auth, Firestore, Storage)
  • AI/Verification: OpenAI (GPT-4o or latest vision model)
  • State Management: React Hooks
  • Styling: Vanilla CSS & Emotion

🚀 Getting Started

🏗️ Project Structure

  • src/components: Reusable UI components.
  • src/pages: Application pages (Home, Challenge Detail, Leaderboard, Upload).
  • src/services: API and external service integrations (Firebase, OpenAI, Geolocation).
  • src/hooks: Custom React hooks for authentication and data fetching.
  • src/utils: Utility functions for calculations and device features.
  • src/data: Static challenge data and types.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request or open an issue for any bugs or feature requests.


Hook 'em! 🤘 This Project was a Created a from an Older Repo Created during the Hackathon. But the Repo had to be taken down due to API Key Leak Issues.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages