#Focus Buddy
Focus Buddy is a productivity web app built with React + TypeScript that helps you stay focused during study or work sessions. It uses your webcam to detect your face and monitor your focus. If you get distracted for a set amount of time, it rings an alarm to bring you back on track.
🚀 Features
🎥 Real-time face detection using your webcam
⏳ Tracks your focus duration
🔔 Rings an alarm when distracted for a specific time
📊 Show focus history and statistics
⚡ Built with React, TypeScript, and face-api.js
🛠️ Tech Stack
Frontend: React, TypeScript
AI/ML: face-api.js
Styling: Tailwind CSS (optional, if you used it)
Build Tool: Vite / Create React App (depending on your setup)
📂 Project Setup
-
Clone the repository git clone https://github.com/your-username/focus-buddy.git cd focus-buddy
-
Install dependencies npm install or yarn install
-
Start development server npm run dev or yarn dev
📸 How It Works
Allow the browser to access your camera
The app continuously checks if your face is detected
If you look away or leave the screen for too long → alarm rings
📦 Deployment
You can deploy this project easily on:
Vercel
Netlify
GitHub Pages
🔮 Future Enhancements
Add eye tracking (to check if you’re looking at the screen)
Show focus reports & charts
Add mobile support for study sessions anywhere
Customizable alarm sounds & timers
🤝 Contributing
Contributions are welcome! If you’d like to improve Focus Buddy, feel free to fork the repo and create a pull request.
✨ Stay focused with Focus Buddy and boost your productivity!