Transform lecture videos into intelligent study guides with real-time active recall prompts

• Real-time comprehension questions during video watching
• Spaced repetition prompts to combat the forgetting curve
• Context-aware questions based on lecture content

• Automatic generation of comprehensive "Teach Me" notes
• Structured learning objectives and key concepts
• Step-by-step explanations with examples

• Beautiful, responsive gallery interface
• Advanced search and filtering capabilities
• Dark mode with stunning gold animations
• Three.js powered particle effects

• You control when recording starts
• Private by default, yours forever
• Export and sync across devices

• Node.js 18+
• Chrome Browser
• PostgreSQL Database (Neon or Supabase)

1. Clone the repository

   git clone https://github.com/yourusername/thinkback.git
   cd thinkback

2. Install dependencies

   # Install all packages
   cd app && npm install
   cd ../web && npm install

3. Set up environment variables

   ⚠️ IMPORTANT: Copy the example files and add your actual API keys:

   # Backend environment
   cp kiro-app/packages/backend/.env.example kiro-app/packages/backend/.env
   
   # Web platform environment  
   cp kiro-app/packages/web-platform/.env.example kiro-app/packages/web-platform/.env

   Then edit the .env files with your actual credentials. See SECURITY.md for details.

4. Set up the database

   cd app/packages/backend
   npx prisma db push
   npm run seed

5. Start the applications

   # Terminal 1: Backend API
   cd app/packages/backend
   npm run dev
   
   # Terminal 2: Web Platform
   cd web
   npm run dev
   
   # Terminal 3: Chrome Extension (optional)
   cd app/packages/extension
   npm run build

6. Load the Chrome Extension

   • Open chrome://extensions/
   • Enable "Developer mode"
   • Click "Load unpacked"
   • Select app/packages/extension/dist

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│  Chrome         │    │  Backend API    │    │  Web Platform   │
│  Extension      │◄──►│  (Node.js)      │◄──►│  (Next.js)      │
│                 │    │                 │    │                 │
│ • Media Capture │    │ • Transcription │    │ • Study Gallery │
│ • Active Recall │    │ • AI Processing │    │ • Dark Mode     │
│ • Overlay UI    │    │ • Note Generation│    │ • 3D Animations │
└─────────────────┘    └─────────────────┘    └─────────────────┘

• Next.js 15 - React framework with App Router
• TypeScript - Type-safe development
• Tailwind CSS - Utility-first styling
• Three.js - 3D animations and particle effects
• NextAuth.js - Authentication with Google OAuth

• Node.js - Runtime environment
• Express.js - Web framework
• Prisma - Database ORM
• Redis - Caching and session management
• PostgreSQL - Primary database

• Manifest V3 - Modern extension architecture
• React - UI components
• Vite - Build tooling
• Service Workers - Background processing

• OpenAI Whisper - Audio transcription
• Google Cloud Vision - OCR processing
• Opennote API - Question generation and summarization

1. Install the Extension - Add ThinkBack to Chrome
2. Start Learning - Navigate to a YouTube lecture and click "Start Session"
3. Active Recall - Answer comprehension questions as they appear
4. Review Notes - Access your generated study guides in the web gallery

1. Fork the Repository - Create your own copy
2. Set Up Development - Follow the installation guide
3. Make Changes - Implement new features or improvements
4. Submit PR - Share your contributions with the community

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.

• OpenAI for Whisper transcription
• Google Cloud for Vision API
• Opennote for AI-powered question generation
• Three.js community for amazing 3D graphics
• Next.js team for the incredible framework