utility

Utility OS is a monochrome academic workspace built for university students using Next.js, Firebase, and Google Drive sync. It consolidates course materials, planning, and AI-powered study tools into a single installable PWA. Core capabilities: - Document Intelligence (Hybrid RAG): Slide-level chunk retrieval combining BM25 keyword search with vector embeddings, grounded citations referencing specific slides and files, and scoping results by branch and semester. - Drive Sync Runtime: Node scripts that mirror a shared Google Drive folder into Firestore, indexing document text for search and maintaining a live resource catalog. - Resource Vault: Organized repository of notes, presentations, question banks, and previous-year exams by branch, semester, and subject. - Study Planner: Collaborative weekly and monthly planning interface with natural-language input. - GPA Calculator: SGPA/CGPA computation with auto-populated subject lists. - SRS Flashcards: Leitner-style spaced repetition system for exam preparation. - Focus Timer: Pomodoro sessions with activity tracking. - PWA: Installable offline-capable client. Tech stack includes Next.js 16 with App Router, Tailwind CSS, Firebase (Firestore and Auth), Google Drive API, Groq for chat/summarization, Gemini for embeddings, Lucide React for icons, and Framer Motion for animations. Setup requires a .env.local with Firebase credentials, Google Drive folder ID, Groq and Gemini API keys, and optional Upstash Redis for production rate limiting. The project supports local development via npm run dev and daily Drive sync through GitHub Actions scheduled at 00:00 UTC.