Knowledge Showdown - Web Quiz

Welcome to the Knowledge Showdown Web Quiz repository! This project is a dynamic web application built with Vue.js for the frontend, Mars Engine for backend logic (JavaScript), and MySQL for data storage. Knowledge Showdown provides an engaging platform for creating, participating in, and managing quizzes on various topics.

Currently hosted at:

Knowledge Showdown

Recommended IDE Setup

VSCode + Volar (and disable Vetur) + TypeScript Vue Plugin (Volar).

Customize Configuration

See Vite Configuration Reference.

Project Setup

Note: To run and build the project, go to Knowledge-Showdown-Web-App folder and run commands there.

cd ./Knowledge-Showdown-Web-App

Install all dependencies for a project

pnpm install

Compile and Hot-Reload for Development

pnpm dev

Compile and Minify for Production

pnpm build

Knowledge.Showdown.Preview.mp4

Features

• User-Friendly Interface: Intuitive and responsive design for an enjoyable user experience.
• Quiz Creation: Easily create quizzes with customizable settings, including duration, difficulty, and question types.
• Quiz Participation: Users can participate in quizzes, answering questions within the specified time frame.
• Leaderboard: Keep track of top performers with a dynamic leaderboard.

Technologies Used

• Vue.js: A progressive JavaScript framework for building interactive user interfaces.
• Mars Engine (JavaScript): A lightweight backend engine for handling quiz logic and interactions.
• MySQL: A robust relational database for storing quiz data and user information.

Getting Started

To set up the Knowledge Showdown Web Quiz locally, follow these steps:

1. Clone the repository: Knowledge Showdown
2. Navigate to the project directory: cd Knowledge-Showdown-Web-Quiz
3. Install dependencies: npm install
4. Configure the database connection in the backend settings.
5. Setup and configure Database.
6. Setup and configure API
7. Start the application: pnpm dev

Access the web application at http://localhost:8080 and begin exploring the Knowledge Showdown!

Project Structure

• frontend: Contains the Vue.js frontend application.
• backend: Houses the Mars Engine(exported as node js) backend logic.
• database: My SQL scripts for initializing the MySQL database.

Contribution Guidelines

Contributions to the Knowledge Showdown Web Quiz project are welcome. If you'd like to contribute, please follow these guidelines:

1. Fork the repository and create your branch.
2. Make your changes and ensure they adhere to the project's coding standards.
3. Test your changes thoroughly to avoid introducing issues.
4. Commit your changes with descriptive messages.
5. Push to your branch and open a pull request.

License

The Knowledge Showdown Web Quiz project is released under the MIT License. You are free to use, modify, and distribute the code according to the terms of the license.

About Us

🌐 About Us:

Welcome to the hub of intellect and fun, where knowledge takes center stage! Knowledge Showdown is not just a game; it's an immersive experience designed for the trivia enthusiast in you. Whether you're a seasoned quiz master or a casual player looking to expand your horizons, we've crafted an engaging platform that promises to challenge, entertain, and enlighten.

🧠 Our Mission:

At Knowledge Showdown, we believe that learning should be exhilarating. Our mission is to create an environment where players can not only test their knowledge but also discover new facts, spark curiosity, and foster a love for continuous learning. We're committed to providing a platform that is not just about winning but about the joy of discovery.

🏆 What Sets Us Apart:

Diverse Categories: From science and history to pop culture and beyond, we've curated a vast array of categories to ensure there's something for every knowledge seeker. Challenging Questions: Prepare to be mentally stimulated with thought-provoking questions, keeping you on your toes from start to finish. User-Friendly Interface: Our sleek and intuitive design makes navigating the game a breeze, allowing you to focus on what matters most—answering questions and having a blast.

🌍 Connect, Learn, Compete:

Knowledge Showdown is more than just a game; it's a global community of like-minded individuals who share a passion for trivia. Connect with fellow players, learn from one another, and compete in friendly battles that transcend geographical boundaries.

📚 Join us

Join us on this exciting journey of exploration and intellectual prowess. Knowledge Showdown is not just a game, it's a celebration of the brilliant minds that make up our diverse community. Let the showdown begin! 🚀