🎓 Smart Study Assistant

🚀 Live Site: smart-study-assistant-taupe.vercel.app

---

💡 Transform Your Study Notes into Superpowered Learning Tools

Smart Study Assistant is a modern, AI-powered study companion designed to optimize your learning workflow. Instead of studying harder, study smarter by instantly turning your notes, PDFs, or documents into structured study plans, quizzes, and customized explanations.

---

🔐 Secure Authentication

Simple, clean, and secure signup and login pages powered by Supabase Auth, featuring live form validation and password visibility toggles:

🔑 Sign In	📝 Sign Up

---

🖥️ Interactive Dashboard in Action

The workspace is designed for maximum study efficiency, featuring auto-saves, dynamic generation panels, and a contextual study chat.

📝 AI Summaries & Study Notes

Paste text or upload files (PDFs, TXT, DOCX) to instantly generate structured summaries, key bullet points, and simplified explanations.

❓ Interactive Practice Quizzes

Test your knowledge by generating custom multiple-choice and short-answer quizzes from your materials, featuring real-time grading and feedback.

---

✨ Features at a Glance

Feature	Description
📝 Smart Summaries	Condense extensive notes or documents into structured markdown summaries and key bullet points.
❓ Interactive Quizzes	Generate dynamic Multiple Choice / Short Answer practice questions with real-time feedback and validation.
💡 Feynman Explainer	Simplify complex terms, physics equations, or academic concepts using clear, intuitive analogies.
💬 Contextual Sidebar Chat	Chat directly with your notes to query, clarify, or expand on any topic within your study material.
🏷️ Auto-Tagging	Automatically categorize your files into academic subjects (Biology, Physics, Chemistry, Math, History, CS, etc.).
📁 Document Parser	Extract text from PDF, TXT, DOC, and DOCX documents with robust binary stream parsing.
🛡️ Hardened Security	Keep your data private with Supabase Row-Level Security (RLS) and secure password-verified account deletion.

---

🛠️ Technology Stack & Architecture

• Frontend: Next.js 15 (App Router, React 19), Tailwind CSS
• Database & Authentication: Supabase (PostgreSQL, GoTrue, Row Level Security)
• AI Cognitive Processing: OpenRouter API (utilizing free-tier LLM models)
• File Processing: pdf-parse

🚀 Local Development Setup

1. Prerequisites

Ensure you have Node.js installed (v18.x or higher is recommended).

2. Configuration (.env.local)

Create a .env.local file in the root of the project with the following configuration:

# Supabase Configuration
NEXT_PUBLIC_SUPABASE_URL=your-supabase-url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-supabase-anon-key
SUPABASE_SERVICE_ROLE_KEY=your-supabase-service-role-key

# AI Provider Configuration
OPENROUTER_API_KEY=your-openrouter-free-api-key

3. Database Schema Setup

Execute the SQL scripts inside supabase/schema.sql within your Supabase project's SQL editor to set up the necessary tables, policies, triggers, and RPC functions.

4. Install Dependencies

npm install

5. Run the Local Server

npm run dev

Open http://localhost:3000 in your browser to view the application.

📦 Production Build & Deployment

Production Builds

To compile and optimize the application for production deployment, run:

npm run build

To preview the built production site locally, run:

npm run start

Deployment

The application is fully compatible with Vercel out of the box:

1. Push the code repository to GitHub, GitLab, or Bitbucket.
2. Go to the Vercel Dashboard and click Add New Project.
3. Import the repository.
4. Input the environment variables (from .env.local) in Vercel's Environment Variables configuration.
5. Click Deploy. Vercel will bundle the codebase and host it on HTTPS.

---

📄 License

This project is open-source and available under the MIT License.