Skip to content

A full-stack web application for crowd-sourced competitive exam questions. Practice, contribute, and excel in your exams with community-generated content.

Notifications You must be signed in to change notification settings

srinjoydutta03/ExamPrep

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

2 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

ExamPrep - Question Aggregation Platform

A full-stack web application for crowd-sourced competitive exam questions. Practice, contribute, and excel in your exams with community-generated content.

๐Ÿš€ Features

  • Question Management: Create, edit, and verify multiple-choice questions
  • AI-Powered Question Generation: Generate variations of existing questions using Cohere AI
  • Quiz System: Create and take quizzes with instant feedback
  • Voting System: Upvote/downvote questions to maintain quality
  • Leaderboards: Track top contributors by verified questions and upvotes
  • Subject Organization: Categorize questions by subjects and difficulty levels
  • User Authentication: Secure login/signup with session management
  • Admin Panel: Administrative controls for content moderation
  • LaTeX Support: Mathematical equations and formatting support
  • Responsive Design: Modern UI with Tailwind CSS

๐Ÿ—๏ธ Architecture

Frontend (/frontend)

  • Framework: React 19 with TypeScript
  • Routing: React Router DOM
  • Styling: Tailwind CSS
  • Math Rendering: KaTeX for LaTeX equations
  • Markdown: React Markdown with math support
  • Build Tool: Vite

Backend (/backend)

  • Runtime: Node.js with Express.js
  • Database: MongoDB with Mongoose ODM
  • Authentication: Express sessions with MongoDB store
  • Password Hashing: bcrypt
  • CORS: Configured for cross-origin requests

AI Service (/mutate-question)

  • AI Provider: Cohere API
  • Framework: LangChain
  • Purpose: Generate question variations

๐Ÿ“‹ Prerequisites

  • Node.js (v16 or higher)
  • MongoDB (local or MongoDB Atlas)
  • Cohere API key (for AI features)

Backend Setup

cd backend
npm install

# Create .env file
cat > .env 
DATABASE_URI=mongodb://localhost:27017/examprep
PORT=3500

AI Service Setup

cd mutate-question
npm install

# Create .env file with your Cohere API key
cat > .env 
COHERE_API_KEY=your-cohere-api-key

Frontend Setup

cd frontend
npm install
npm run dev

About

A full-stack web application for crowd-sourced competitive exam questions. Practice, contribute, and excel in your exams with community-generated content.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published