# Hunt Feature Demo Script

## Setup Instructions

1. **Build and Install the App**:
   ```bash
   cd d:\LBA\lba
   flutter build apk --debug
   flutter install
   ```

2. **Navigate to Hunt Section**:
   - Open the app
   - Tap on the "Hunt" tab in the bottom navigation

## Demo Walkthrough

### Part 1: Card Selection (00:00 - 01:30)
1. **Show the main Hunt screen**:
   - Point out the "Treasure Hunt" title
   - Highlight the user's current points and rank
   - Read the instructions box

2. **Explore the Hunt Cards**:
   - Scroll through the 5 available cards
   - Show different point values (200, 180, 150, 120, 100)
   - Highlight different categories (Restaurant, Electronics, Coffee Shop, etc.)
   - Point out the category icons and point indicators

3. **Select a Hunt Card**:
   - Tap on the highest point card (Restaurant - 200 points)
   - Show the card flip animation
   - Read the mystery question aloud
   - Point out the 12-hour timer

### Part 2: Hunt Activation (01:30 - 03:00)
1. **Start the Hunt**:
   - Tap "Start Hunt" in the dialog
   - Allow location permissions when prompted
   - Show the active hunt interface

2. **Explain the Interface**:
   - Point out the countdown timer at the top
   - Show the selected card with the mystery question
   - Explain the two action buttons: "Get Hint" and "Leaderboard"

3. **Check Hunt Status**:
   - Scroll down to show the Hunt Status section
   - Point out Location Access, Camera Access, and Time Remaining

### Part 3: Hint System (03:00 - 04:30)
1. **Access the Hint Feature**:
   - Tap "Get Hint" button
   - Allow camera permissions when prompted
   - Show the AR camera interface

2. **Demonstrate AR Scanner**:
   - Point out the scanning animations
   - Show the corner brackets and scanning circle
   - Explain that you need to be near the target location (100m range)
   - Show the instructions at the bottom

3. **Exit Hint Mode**:
   - Tap the close button to return to hunt

### Part 4: Leaderboard (04:30 - 05:30)
1. **Open Leaderboard**:
   - Tap "Leaderboard" button
   - Show the slide-up animation
   - Point out the different ranks and point totals

2. **Highlight Features**:
   - Show the user's highlighted position
   - Point out the trophy icons for top 3
   - Show the different rank colors (Gold, Silver, Bronze)
   - Demonstrate the close handle and close button

### Part 5: Hunt Completion Simulation (05:30 - 07:00)
1. **Simulate Hunt Success**:
   - For demo purposes, manually trigger completion
   - Show the success animation and sound effects
   - Display the congratulations dialog

2. **Points Award**:
   - Show the points being added (+200 points)
   - Demonstrate the "View Leaderboard" option
   - Show how the user's rank changes in the leaderboard

3. **Reset for New Hunt**:
   - Tap "Play Again" 
   - Return to card selection screen
   - Show how points are maintained

## Key Features to Emphasize

### Visual Design
- **Professional UI**: Modern card-based design
- **Smooth Animations**: Card flips, scale effects, slide transitions
- **Dark/Light Mode**: Works perfectly in both themes
- **Responsive Layout**: Adapts to different screen sizes

### Gamification Elements
- **Point System**: Different cards offer different rewards
- **Time Pressure**: 12-hour countdown creates urgency
- **Competition**: Real-time leaderboard with rankings
- **Achievement**: Celebration effects on completion

### Technical Excellence
- **Location Integration**: Real GPS monitoring
- **AR Capabilities**: Camera-based hint system
- **Permission Handling**: Smooth user experience
- **State Management**: Proper data flow and updates

### User Experience
- **Intuitive Interface**: Clear instructions and visual cues
- **Progressive Disclosure**: Information revealed step by step
- **Accessibility**: Good contrast and readable text
- **Feedback**: Audio, visual, and haptic responses

## Demo Tips

1. **Prepare the Environment**:
   - Ensure good lighting for camera demo
   - Have location services enabled
   - Test on a physical device (not emulator)

2. **Narrative Flow**:
   - Start with the problem: "How do we make exploring the city more engaging?"
   - Show the solution: "Gamified treasure hunts with AR hints"
   - Demonstrate value: "Social competition with real rewards"

3. **Technical Highlights**:
   - Mention real-time location monitoring
   - Emphasize the AR scanning technology
   - Point out the professional animation work
   - Show the responsive design switching themes

4. **Future Potential**:
   - Explain how this connects to real businesses
   - Mention potential for partnerships with local stores
   - Discuss scalability for different cities
   - Show integration possibilities with existing features

## Troubleshooting

- **Camera not working**: Check permissions in device settings
- **Location not detected**: Ensure GPS is enabled and app has permission
- **Cards not loading**: Wait for animation to complete
- **Timer not starting**: Verify location permission is granted

## Mock Data Locations

All hunt cards currently point to: `32.62501010252744, 51.72622026956878`
This allows for easy testing without actually traveling to multiple locations.
