Skip to content

πŸš€ A dynamic quiz generator 🧠. Create quizzes for different student classes, courses, and chapters πŸ“š.Track progress πŸ“ˆ, view detailed explanations, and calculate the final score! 🎯

License

Notifications You must be signed in to change notification settings

yassindaboussi/QCMBuilder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

9 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

QCM Builder πŸš€

QCM Builder is an exciting web application 🌐 crafted with Node.js and Angular, tailored for generating multiple-choice questions (QCM). Ideal for various student classes and courses πŸ“š, it simplifies the process of selecting chapters, generating QCMs πŸ”, providing detailed explanations for correct and incorrect answers, and even tracking progress πŸ“Š.

Project Structure πŸ—οΈ

The project is neatly organized into two primary folders:

Node πŸ–₯️

This folder houses the backend logic implemented in Node.js. It takes charge of generating QCMs and furnishing the necessary APIs for the Angular frontend.

Angular 🌐

The Angular folder encompasses the frontend code, offering an intuitive user interface. Users can seamlessly navigate through classes, courses, and chapters, answer questions, access explanations, and monitor progress.

Getting Started πŸš€

To run the project locally, follow these straightforward steps:

Node (Backend) πŸš€

  1. Navigate to the Node folder.
  2. Install dependencies using npm install.
  3. Run the server using npm run dev.
  4. The Node.js server will be up and running on a specified port (default is http://localhost:3000).

Angular (Frontend) 🌐

  1. Move to the Angular folder.
  2. Install dependencies using npm install.
  3. Initiate the Angular development server with ng serve.
  4. Open your browser and head to http://localhost:4200.

Usage 🎯

  1. 🌐 Access the Angular application in your browser.
  2. πŸŽ“ Choose the relevant student class, course, and chapters.
  3. πŸš€ Generate the QCM effortlessly.
  4. πŸ€” Answer the questions, and detailed explanations await for both correct and incorrect answers.
  5. πŸ“Š Keep an eye on your progress through the intuitive progress bar.
  6. πŸ† Get a glimpse of your final score based on correct answers.

Screenshots πŸ“·

Explore the visual journey with these snapshots:

Image 1

Snapshot of the Class Selection Screen

Image 2

Snapshot of the Course Selection Screen

Image 3

Snapshot of QCM Generation in Progress

Image 4

Snapshot of Answering Questions with Explanations

Image 5

Snapshot Final Score

Technologies Used πŸ› οΈ

  • Node.js
  • Angular
  • MongoDB

🌟Star this repository🌟

Please ⭐️ this repo and share it with others

HITS Flutter Angular ExpressJS MongoDB

View-Only License

This project is licensed under the View-Only License. See the LICENSE file for details.

(back to top)

About

πŸš€ A dynamic quiz generator 🧠. Create quizzes for different student classes, courses, and chapters πŸ“š.Track progress πŸ“ˆ, view detailed explanations, and calculate the final score! 🎯

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published