# 🎯 Project Spec: StudyGroup Finder

## Overview
An app to find and form study groups for AP/IB CS exams and regular classes. Students study alone because they can't find partners — this fixes that.

**Target Users**: AP CS, IB CS, and intro coding students
**Impact Goal**: 200+ study groups formed
**Time to Build**: 3-4 weeks

---

## Impact First

### Problem
- Students study alone because they can't find study partners
- Group study is more effective (explaining solidify knowledge)
- No platform exists specifically for CS students

### Impact
- **Study Groups**: 200+ groups formed
- **Grades**: Measure group vs. individual improvement
- **Community**: CS students connect with peers

### Leadership
- Creating community connections
- Organizing peer learning at scale

---

## Technical Stack

| Component | Technology | Cost |
|-----------|------------|------|
| Frontend | React + Vercel | $0 |
| Backend | Firebase (free tier) | $0 |
| Auth | Firebase Auth | $0 |
| Database | Firestore | $0 |

---

## Features

### MVP
1. **Create/Join Group**: Form study group with subject, time, location
2. **Browse Groups**: See available groups
3. **Request Join**: Request to join existing group
4. **Chat**: Simple messaging within app
5. **Schedule**: Recurring session reminders

### Version 2
1. **Study Materials**: Share notes/files
2. **Pomodoro Timer**: Built-in study timer
3. **Analytics**: Track study hours

---

## User Flow

```
1. Sign up with school email
2. Create group OR browse available groups
3. Request to join OR accept requests
4. In-app chat to coordinate
5. Track study sessions
```

---

## Implementation

### Week 1: Auth + Groups
- [ ] Set up Firebase project
- [ ] Create React app
- [ ] Implement auth
- [ ] Create group form

### Week 2: Matching + Chat
- [ ] Browse groups list
- [ ] Join request functionality
- [ ] Basic chat

### Week 3: Polish
- [ ] Add search/filter
- [ ] Mobile optimization
- [ ] Push notifications

---

## Metrics

| Metric | Target |
|--------|--------|
| Groups Formed | 200+ |
| Active Users | 100+ |
| Sessions Logged | 500+ |

---

*Spec completed: 2026-04-28*

*Generated by Hermes Babu*