Skip to content

Dive into a world of knowledge with QuizMaster, a trivia app covering a variety of topics, from books and science to video games!

Notifications You must be signed in to change notification settings

Majid-Hassan/Quiz-Master

Repository files navigation

QuizMaster: Your Ultimate Quiz Experience

Dive into a world of knowledge with QuizMaster, a trivia app covering a variety of topics, from books and science to video games!

Features

  • Diverse Topics: Questions from books, general knowledge, films, science, sports, and more.
  • Interactive UI: An engaging and user-friendly interface built with Tailwind CSS.
  • Real-time Data: Fetch questions from a trivia API for an exciting quiz experience.
  • Animations: Smooth transitions and animations using Framer Motion.
  • Theming: Light and dark mode support with Next Themes.
  • Persistent State: Use of Zustand for state management.

Installation

To get a local copy up and running follow these simple steps.

  1. Clone the repo:
    git clone https://github.com/yourusername/quiz-app.git  
  2. Navigate to the project directory:
    cd quiz-app  
  3. Install the dependencies:
    npm install
    or
    pnpm install
  4. Start the development server:
    npm run dev
    or
    pnpm run dev   

Usage

Once the app is running, navigate to http://localhost:3000 and enjoy the quiz! Choose a topic, answer the questions, and see how you score!

Tech Stack

  • React: For building the user interface.
  • Next.js: For server-side rendering and routing.
  • TypeScript: For static type checking.
  • Recharts: For rendering charts.
  • Tailwind CSS: For styling.
  • Framer Motion: For animations.
  • Zustand: For state management.
  • next-themes: For theming support.
  • shadcn-ui: For UI components.

Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated!

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests.

License

Distributed under the MIT License. See LICENSE for more information.

Live Demo

Check out the live demo of QuizMaster here.

Contact

Your Name - your.email@example.com

Project Link: https://github.com/yourusername/quiz-app

FAQ

Q: Can I suggest new topics?
A: Absolutely! Please open an issue or a pull request with your suggestions.

Q: Can I use this in my own project?
A: Yes! Feel free to use the code as per the MIT license.

About

Dive into a world of knowledge with QuizMaster, a trivia app covering a variety of topics, from books and science to video games!

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published