IntegriTest is a full-stack web application designed for educators who need a reliable, secure, and integrity-focused platform to conduct online quizzes. It minimizes cheating and distractions, offering a focused testing environment for students.
This project is open-source and welcomes contributions β especially for Hacktoberfest 2025! π
-
Secure Authentication β Sign up and log in to a personal dashboard.
-
Quiz Dashboard β Create, view, edit, and delete quizzes easily.
-
Dynamic Quiz Creator
- Add titles, instructions, and duration-based time limits.
- Include multiple-choice questions with designated correct answers.
-
Scheduled Quizzes β Set specific start and end times for access control.
-
Anti-Cheating Controls β Teachers can enable tab-switch prevention and screenshot blocking to maintain academic integrity during the quiz.
-
Result Analytics β View submissions, scores, and detailed performance breakdowns.
- No Account Needed β Join instantly via a quiz link.
- Focused UI β Minimal and distraction-free interface showing one question at a time.
- Live Countdown Timer β Auto-submits upon timeout.
- Instant Feedback β View score and correct answers right after submission.
- Tab Switch Detection β The quiz automatically submits if a student switches tabs or minimizes the browser window. Teachers are instantly notified of the event.
- Screenshot Protection β When a student attempts to take a screenshot, the screen automatically turns black to prevent quiz content from being captured.
- Content Protection β Right-clicking, text selection, and copy-paste actions are disabled during the quiz to prevent cheating and content theft.
| Layer | Technology |
|---|---|
| Frontend | React (with React Router & Context API or Zustand) |
| Backend | Node.js + Express.js |
| Database | PostgreSQL or MySQL |
| Authentication | JSON Web Tokens (JWT) |
| Styling | Tailwind CSS (or your preferred framework) |
Follow these instructions to run the project locally for development and testing.
- Node.js and pnpm (or yarn)
- PostgreSQL (or another SQL database)
https://github.com/Student-Chapter-CSE/IntegriTest.git
cd integritestcd server
pnpm installCreate a .env file (copy from .env.example) and fill in:
DATABASE_URL="postgresql://user:password@localhost:5432/integritest" PORT=5000 JWT_SECRET="your_super_secret_key"
Run migrations if applicable, then start the backend:
pnpm dev
cd client
pnpm install
pnpm devNow open: π http://localhost:3000
π API Endpoints Overview
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/auth/register |
Register a new teacher |
| POST | /api/auth/login |
Log in a teacher & receive JWT |
| GET | /api/quizzes |
Fetch all quizzes for the logged-in teacher |
| POST | /api/quizzes |
Create a new quiz |
| GET | /api/quizzes/:id |
Fetch details of a single quiz |
| PUT | /api/quizzes/:id |
Update a quiz |
| DELETE | /api/quizzes/:id |
Delete a quiz |
| GET | /api/session/:quizUrlId |
Fetch quiz details for a student |
| POST | /api/submissions |
Submit student answers & calculate score |
| GET | /api/submissions/quiz/:quizId |
View all submissions for a quiz |
We β€οΈ contributions! Whether itβs fixing a bug, improving documentation, or adding new features β every bit helps!
-
Fork the repository
-
Create a new branch
git checkout -b your_branch_name
-
Commit your changes
git commit -m "Add AmazingFeature" -
Push to your branch
git push origin your_branch_name
-
Open a Pull Request
π‘ Check issues tagged with good first issue or hacktoberfest to get started!
π» GitHub: Students' Chapter CSE AOT π Project Repo: IntegriTest