# SnapLens Challenge

SnapLens Challenge is a viral growth web application designed to drive engagement through Snapchat lenses. Users participate by completing lens challenges, referring friends, and competing on leaderboards for rewards.

## Core Features
- **Lens Challenges**: Take snaps with specific Snapchat lenses and submit proof.
- **Points System**: Earn 100 points for approved submissions and 50 points per referral.
- **Referral System**: Unique referral codes and social sharing to boost scores.
- **Giveaway System**: Dynamic scoring algorithm for ranking giveaway participants.
- **Leaderboard**: Real-time rankings with badges (Trophy, Medal, Award).
- **Rewards**: Points-based reward catalog for unlocking exclusive items.

## Tech Stack
- **Frontend**: React 18, TypeScript, TanStack Router, TanStack Query.
- **Build/Server**: Vite 7, Nitro APIs.
- **Backend/DB**: Firebase (Firestore, Auth), Cloudinary (Image Storage).
- **Styling**: Tailwind CSS, shadcn/ui, Framer Motion.

## Navigation
- `/`: Home page with challenge details.
- `/submit`: Form for submitting challenge proof.
- `/refer`: Referral dashboard and stats.
- `/leaderboard`: Real-time rankings.
- `/rewards`: Reward catalog.
- `/profile`: User stats and history.

## Full Documentation
- [llms-full.txt](/llms-full.txt)