Skip to content

Quizel is a simple and fun quiz website I built to make learning a little more exciting. You can take multiple-choice quizzes, see your score as you go, and even play with a timer if you like a challenge.

Notifications You must be signed in to change notification settings

RanaVinit/Quizel

Repository files navigation

QuizeL Banner

QuizeL — Learn Smarter. Play Harder.

HTML5 CSS3 JavaScript Vercel

QuizeL is a lightweight, fully responsive quiz web app that makes learning interactive and fun.
Open the app, pick a quiz, answer multiple-choice questions, and get instant feedback.


Features

  • Built-in Quizzes: Ready-to-play quizzes loaded from builtin_quizzes.json.
  • Client-side Only: Runs entirely in the browser — no server or DB needed.
  • Instant Feedback: See your score immediately after completing a quiz.
  • Responsive: Works across mobile, tablet, and desktop.
  • Easy to Customize: Add or edit quizzes via builtin_quizzes.json.

Getting Started

Prerequisites

  • A modern web browser (Chrome, Edge, Firefox, Safari).
  • LiveServer Extension

Run Locally

  1. Clone the repository
    bash git clone https://github.com/RanaVinit/Quizel.git
  2. Open the folder in VS Code
  3. Right-click index.html and select "Open with Live Server"

Creating a Quiz

  1. Click on "Create Quiz" from the home page.
  2. Enter a Quiz name.
  3. Add questions to your quiz.
  4. Click "Save Quiz" when you're finished.

Taking a Quiz

  1. Click on "Take a Quiz" from the home page.
  2. Select a quiz from the available options.
  3. Choose the number of questions for your quiz.
  4. Start the quiz and answer the questions.
  5. View your results at the end of the quiz.

Viewing Previous Scores

  1. Click on "Previous Scores" from the home page.
  2. Review your past quiz performances, including date, quiz name, and score percentages.

Project Structure

  • assets/: Images, Icons, banner
  • builtin_quizzes.json: Preloaded quiz data
  • index.html: Main HTML file
  • styles/: Styles and responsive layout
  • scripts/: Quiz logic and UI interactions
  • README.md: Documentation

Technologies Used

  • HTML5
  • CSS3
  • JavaScript (ES6+)
  • LocalStorage for client-side data persistence

Hosting with Vercel

Quizel is hosted on Vercel, providing fast and reliable access to the application. You can access the live version at https://quizel.vercel.app.

Contact

Vinit Rana - LinkedIn

Project Link: https://github.com/RanaVinit/Quizel


Made with ❤️ by Vinit Rana

About

Quizel is a simple and fun quiz website I built to make learning a little more exciting. You can take multiple-choice quizzes, see your score as you go, and even play with a timer if you like a challenge.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published