Shake Up Your Study Routine with AI-Powered Tools

Spark and Prepper is an AI-powered web app designed to make studying more efficient and interactive. Upload your course materials — like lecture notes, syllabi, or slides — and let our system turn them into structured study guides, quizzes, flashcards, mock exams, and cheat sheets powered by Google's Gemini API.

Whether you're preparing for finals or just want to keep up with your coursework, Spark and Prepper helps you study smarter, not harder.

• 📄 Upload lecture notes, syllabi, and more
• 🤖 AI-generated Study Guides
• 📝 Auto-generated Flashcards
• 🎓 Practice with Mock Exams
• 💡 Create custom Cheat Sheets
• 💬 Chat with an AI Tutor (Chatbot)

• Front-End:

  • React
  • Tailwind CSS
  • Vite
  • React Router

• Back-End:

  • Node.js
  • Express.js
  • Firebase (Storage & Auth)

• AI Integration:

  • Gemini API

• Devpost

• Node.js and npm installed
• Firebase project & Gemini API key

You'll need two terminals: one for the backend server and another for the frontend client.

# Clone the repository
git clone https://github.com/seifotefa/sparkandprepper.git
cd sparkandprepper

# Go into backend folder
cd backend

# Install dependencies
npm install

# Start the backend server
node server.js

# Open a new terminal
cd sparkandprepper

# Go into frontend folder
cd sparkandpepper_frontend

# Install dependencies
npm install

# Run the frontend app
npm run dev

3. Set up Firebase and API keys:

Create a .env file and add:

VITE_GEMINI_API_KEY=your_gemini_api_key

your firebaseKey in json format

4. Run the app:

npm run dev

in the frontend

• Users upload their course materials.
• Backend (Node.js + Express) sends files to the Gemini API.
• Gemini processes and creates custom study guides, flashcards, and quizzes.
• Firebase stores uploaded files and user data.
• Frontend displays interactive tools to help users study.

• Seif Otefa — Fullstack Developer, Project Lead, Connecting Back and Front End, Gemini API Integration
• Youseph El-Khouly — Backend Developer, Gemini API Integration, Firebase Integration
• Ahmed Aly — Frontend Developer, UI/UX, Demo and Designs

• Gemini API integration across multiple file types
• File upload handling with Firebase Storage
• Building smooth, responsive UI/UX
• Authentication (implemented as a functional demo)

• Improve authentication with full Firebase Auth
• Support more file types (PPT, images)
• Enhance AI accuracy for study guide generation
• Mobile-friendly version

“Shake up your study routine with Spark and Prepper — because smarter studying leads to bigger wins.” 🚀