TestLoom 🎓

Next-Generation Educational Technology Platform

Transform your exam preparation with intelligent OCR technology, adaptive learning algorithms, and collaborative study environments.

---

🚀 Quick Start

# Clone the repository
git clone https://github.com/shuv-amp/TestLoom.git
cd TestLoom

# Install dependencies
pnpm install

# Start development servers
pnpm dev

# Or use Docker
pnpm docker:dev

---

🌟 About TestLoom

TestLoom revolutionizes university exam preparation by combining cutting-edge OCR technology with intelligent learning algorithms. Our platform transforms scattered study materials into organized, interactive learning experiences that adapt to each student's unique needs.

🎯 Why TestLoom?

• 📈 98% Success Rate - Students using TestLoom show significant improvement in exam performance
• ⚡ 70% Time Savings - Streamlined study process with intelligent content organization
• 🔒 Enterprise Security - Bank-grade security with encrypted data protection

---

✨ Key Features

🔍 Smart Question Bank Organized MCQs and fill-in-the-blank questions categorized by year, subject, and difficulty level with advanced filtering options.	📷 OCR Integration Upload physical question papers and convert them into digital quizzes using advanced OCR technology with 95%+ accuracy.	🧠 Adaptive Learning AI-powered personalized quizzes that adapt to your learning pace and identify knowledge gaps in real-time.
💬 Collaborative Forums Community-driven discussion spaces for doubt-solving, resource sharing, and peer-to-peer learning support.	📊 Performance Analytics Detailed insights into your study patterns, strengths, weaknesses, and progress tracking with visual dashboards.	🔐 Secure & Scalable Enterprise-grade security with JWT authentication, data encryption, and infrastructure designed to handle thousands of users.

---

🛠️ Technology Stack

Frontend

Backend

Services & Tools

---

🚀 Quick Start

Prerequisites

Before you begin, ensure you have the following installed:

• Node.js (v20.x or higher)
• MongoDB (v6.x or higher)
• Git

📦 Installation

1. Clone the repository

   git clone https://github.com/shuv-amp/TestLoom.git
   cd TestLoom

2. Install dependencies

   # Install server dependencies
   cd server && npm install
   
   # Install client dependencies
   cd ../client && npm install

---

🏗️ Architecture Overview

---

📚 API Documentation

🔐 Authentication Endpoints

POST /api/auth/register
POST /api/auth/login
POST /api/auth/refresh
POST /api/auth/logout

📝 Question Management

GET    /api/questions?subject=math&difficulty=medium
POST   /api/questions
PUT    /api/questions/:id
DELETE /api/questions/:id

📊 Analytics

GET /api/analytics/performance
GET /api/analytics/progress
GET /api/analytics/recommendations

---

👥 Our Amazing Contributors

🙋‍♂️ Support & Community

Get Help & Connect

---

If TestLoom helps you ace your exams, consider giving us a ⭐️!