📚 FocusOS – Study OS for the Digital Age

🌱 Inspiration

During my online curriculum, I often found myself distracted and unmotivated. Some friends suggested I study with them on collaborative student sites. While the idea was helpful, I struggled to feel their presence — I couldn't see them, hear them, or truly feel like we were studying together. This lack of connection made me lose motivation quickly.

So, I thought: Why not build something better myself?

Initially, it was just a passing idea. I even forgot about it... until I stumbled upon the Devpost Hackathons. While brainstorming for ideas, the old plan came back to me — and it instantly felt right.

I realized there must be many students like me, who want to study sincerely but struggle due to poor organization, lack of motivation, or a sense of isolation. This project is for them — and for me.

🧠 What I Learned

Integrating Firebase Authentication for user data handling.
Building real-time features using Socket.IO.
Using Agora API for live video streaming.
Implementing MathJax for rendering math seamlessly (e.g., ( \int_{a}^{b} f(x),dx )).
Integrating Gemini 2.5 Flash API to provide an AI study companion.
Applying principles of gamification to boost motivation.
Creating a smooth and distraction-free Pomodoro interface.
Managing state and performance in a full-stack project with multiple APIs.

🛠️ How I Built It

Here’s an overview of the system and features:

🔐 Authentication

Used Firebase for login and user data storage.
Skipped email verification to keep things fast and frictionless.

⏱️ Study Environment

Pomodoro Timer: Customizable study/break times.
Notification System: Alerts for break time, achievements, and goals.
Gamification: Includes XP, quests, levels, and leaderboards to keep the dopamine coming.

📝 Productivity Tools

To-Do List: Organize daily tasks.
Customization: Background music, static/video wallpapers — creating a personal study "OS" vibe.

🤖 AI Integration

Gemini 2.5 Flash API is used for a built-in AI bot that:
- Solves student doubts.
- Acts as a study buddy.
Integrated with MathJax to support LaTeX-style rendering for math problems and formulae.

🧑‍🤝‍🧑 Study Room (Social Learning)

Built using Socket.IO for real-time collaboration.
Includes:
- Live Chat
- Live Video Rooms powered by Agora API, offering 10,000 free minutes monthly.
- Students can see each other studying — recreating a true classroom vibe.

😅 Challenges Faced

⚙️ Hosting issues: I initially chose Render for deployment, but ran into multiple issues — broken builds, configuration errors, and unclear logs. It took about 4–7 days of trial and error to finally get things up and running smoothly.
🎥 Video streaming platform: Finding a good, reliable, and affordable video streaming solution was a huge challenge. After exploring several options (with limited documentation or free usage), I finally landed on Agora, which provided a generous free tier and solid performance. This decision came after a lot of research and testing.
🔔 Notification system chaos: Midway through the project, while adding more features to the notification system, the entire app flow broke. Debugging the issue was difficult, and in the end, I had to rebuild major portions from scratch to get things stable again.
🔄 Real-time sync issues: Integrating Socket.IO for study rooms brought challenges in managing real-time updates, especially when syncing video, chat, and presence data between users.
🤖 AI and Math rendering: Combining Gemini API for doubt-solving with MathJax for rendering LaTeX equations required careful handling of asynchronous data and formatting in real-time.

Despite the setbacks, every bug and broken flow became a valuable learning opportunity.

🚀 Conclusion

This project is more than just a productivity tool — it’s a study ecosystem built by a student, for students. It aims to help anyone who struggles with staying organized, staying motivated, or studying alone.

Whether you're grinding out assignments, prepping for exams, or just trying to focus — FocusOS offers a space that feels real, connected, and rewarding.

Through all the debugging, research, and restarts, I gained not just technical skills, but a deeper understanding of how thoughtful design and persistence can turn a personal problem into a meaningful solution for many.