Photo Quest

Take photos outside, vote, and climb the ranks!

Comment

PhotoQuest

Take outdoor photos. Get points. Beat your friends!

=============================================================================

What is PhotoQuest?

PhotoQuest is a fun app that gives you daily photo challenges. Take a picture outside, and our AI scores it. Earn points, level up, and compete on the leaderboard!

What You Can Do:

  • Get 3 new photo quests every day
  • Take photos with your camera
  • AI judges your photo and gives you points
  • Vote on other people's photos (like/dislike)
  • Earn XP and level up (30 levels!)
  • Compete on the leaderboard
  • Keep daily streaks going

=============================================================================

How to Run PhotoQuest

What You Need First:

  1. Flutter - Download from flutter.dev
  2. Node.js - For the backend server
  3. Firebase - Create a free account at firebase.google.com

Step 1: Get the Code

git clone https://github.com/Geaux-Hack-Dish3/Photo-Quest/tree/main1.git cd main1

Step 2: Install Everything

flutter pub get

Step 3: Start the Backend Server

IMPORTANT: You MUST start the server FIRST before running the app!

Open a NEW terminal window (keep it open) and run: node server.js

You should see: "PhotoQuest Backend Server running on port 3000"

Keep this terminal running! Do not close it.

Step 4: Run the App

For Web (Chrome): flutter run -d chrome

For Android Phone: flutter run

For iPhone: flutter run -d ios

Step 5: Create an Account

When the app opens:

  1. Click "Sign Up"
  2. Enter a username, email, and password
  3. Start taking photos!

=============================================================================

How the App Works

Taking Photos:

  1. Open the app and see 3 daily quests
  2. Tap "Start Quest" on any quest
  3. Take a photo or choose from your gallery
  4. Submit it
  5. AI grades it (0-10 score)
  6. Get 100 XP if approved!

Getting Points:

  • Complete a quest: 100 XP
  • Someone likes your photo: +20 XP
  • Someone dislikes your photo: -20 XP
  • Keep your streak going: Bonus XP!

Leveling Up:

  • You start at Level 1 (Outdoor Newbie)
  • Earn XP to reach Level 30 (Legendary Explorer)
  • Each level needs more XP than the last

=============================================================================

Troubleshooting

"Failed to get rating from server" error?

  • YOU MUST START THE SERVER FIRST! Open a new terminal and run: node server.js
  • Make sure you see "PhotoQuest Backend Server running on port 3000"
  • Keep the server terminal open while using the app

App won't start?

  • Make sure the backend server is running (node server.js)
  • Check that port 3000 is free
  • Try closing and restarting both the server and app

Can't take photos?

  • Make sure you allowed camera permissions
  • Try picking from gallery instead

Not getting points?

  • AI only gives points for outdoor photos
  • Make sure your photo matches the quest

=============================================================================

Made By

Team Geaux-Hack-Dish3 for the hackathon!

Team Member Names:

  • Jakobe Allen
  • Edward Summitt
  • Kelvin O'Young

=============================================================================

Now go outside and start taking photos!

Built With

Share this project:

Updates