Add comprehensive README for PushLink

README.md

@@ -1 +1,195 @@
-# PushLink
+# 💪 PushLink
+### Push Friends — Social Pushup Challenge App
+
+---
+
+## 🎯 Core Idea
+
+Turn daily pushups into a competitive social game, not a lonely workout.
+
+> Everyone says they want to work out.
+> Very few stay consistent.
+
+**Friends + light competition + proof = consistency.**
+
+Think: Strava energy + BeReal proof + Duolingo streak pressure — but for pushups.
+
+---
+
+## 🔑 Core Features (MVP)
+
+### 1️⃣ 3–5 Second Proof Clip (Privacy-First)
+
+- User records a short clip of them doing pushups.
+- Options:
+  - Record 5 seconds mid-set
+  - OR record final rep count
+- After verification:
+  - Clip auto-deletes
+  - Only rep count stays visible
+- **Future AI verification (Phase 2):**
+  - Detect body position
+  - Count reps
+  - Prevent fake logging
+
+> 👉 This prevents fake check-ins and makes it real.
+
+---
+
+### 2️⃣ Daily Rep Goal System
+
+- Users choose:
+  - 20 pushups/day
+  - 50 pushups/day
+  - 100 pushups/day
+  - Custom goal
+- Or use:
+  - Progressive goal (auto +5 per week)
+- Goal types:
+  - Daily total
+  - Single-set max
+  - Cumulative weekly challenge
+
+---
+
+### 3️⃣ Friends & Group Battles
+
+- Add friends.
+- Create groups:
+  - "30-Day Chest Builder"
+  - "Frat Pushup War"
+  - "Startup Founder Strength"
+  - "Dorm Floor Domination"
+- See:
+  - Daily rep count
+  - Current streak
+  - Weekly leaderboard
+  - Who hasn't logged today 😈
+
+---
+
+### 4️⃣ Streaks & Pressure Mechanics
+
+- 🔥 Streak counter
+- 🔥 "Perfect week" badge
+- 🔥 Longest streak leaderboard
+
+Miss a day?
+- Streak breaks.
+- Group sees it.
+- Social accountability hits harder than notifications.
+
+---
+
+### 5️⃣ Competitive Alerts
+
+Reminder styles:
+
+- **Motivational:** "You're 15 reps away from today's goal 💪"
+- **Competitive:** "Jake just passed you."
+- **Savage Mode (optional):** "You're last in your group."
+
+> Group-based reminders > solo reminders.
+
+---
+
+## 🌟 What Makes This Unique
+
+| Most workout apps | PushLink |
+|---|---|
+| ❌ Solo | ✅ Social |
+| ❌ Self-reported | ✅ Proof-based |
+| ❌ Easy to fake | ✅ Competitive |
+| ❌ Boring charts | ✅ Streak-driven & frictionless |
+
+It feels like:
+- BeReal + pushups
+- Duolingo streak pressure
+- Fantasy sports energy
+
+---
+
+## 🧠 Behavioral Psychology Behind It
+
+- **Micro-commitment** (just 20 reps)
+- **Social comparison**
+- **Visible streak loss**
+- **Real-time leaderboard shifts**
+- **Short proof = accountability**
+
+> You're not building muscles first.
+> You're building consistency.
+
+---
+
+## 🚀 Optional Features (Post-MVP)
+
+### 🔥 Live Push Window (BeReal Mode)
+- Random time each day: "PushWindow active — you have 10 minutes."
+- Everyone does pushups at once.
+
+### 📊 Strength Profile
+- Stats: weekly total reps, fastest 50, longest streak, lifetime reps
+- Push personality:
+  - The Grinder
+  - The Sprinter
+  - The Comeback Kid
+  - The Ghost (logs last minute 😭)
+
+### 🧠 AI Rep Counter
+- Camera auto-counts reps.
+- Flags half reps.
+- Ensures proper form.
+
+### 🏫 College Mode (Huge Market)
+- Dorm vs Dorm battles
+- Fraternity vs Fraternity
+- Club challenges
+- Loser buys pizza.
+
+### 💼 Corporate Mode
+- Team challenges: "Marketing vs Engineering"
+- Office wellness competitions
+
+---
+
+## 💸 Monetization (Later)
+
+**Free:**
+- Friends
+- Basic leaderboard
+- Standard challenges
+
+**Pro:**
+- Advanced stats
+- AI rep counter
+- Custom challenge rules
+- Large group sizes
+- Badges + cosmetics
+
+**Brand deals:**
+- Fitness brands
+- Supplements
+- Apparel
+- Gyms
+
+---
+
+## 🏆 Why This Could Actually Work
+
+| Factor | Why It Works |
+|---|---|
+| Pushups | No equipment, universal, simple, measurable, competitive |
+| Short video | Low friction, high accountability |
+| Friends | Hard to ignore, builds identity |
+| Daily habit | Builds physique, discipline, and bragging rights |
+
+---
+
+## 🔥 Tagline Ideas
+
+- *"Out-rep your friends."*
+- *"Proof > promises."*
+- *"No gym. No excuses."*
+- *"Strength is social."*
+- *"Last place does burpees."*