Skip to content

atakann/quizmate

Repository files navigation

AI Quiz Platform

Welcome to the AI Quiz Platform - a robust and dynamic platform built with Next.js 13.4, leveraging OpenAI's LLM API to create an engaging quizzing experience!

Features

  • Full Stack Next.js 13.4 Application: Modern, server-side rendered web application.
  • OpenAI Integration: Generate multiple choice or open-ended questions using OpenAI's advanced LLM API.
  • Authentication: Secure login using Google thanks to Next Auth.
  • Database: Powered by Prisma with PlanetScale cloud-based MySQL ensuring data reliability and scalability.
  • UI Components: Beautiful and responsive design using tailwind.css, lucide, and shadcn.
  • User History: Users can review their past quizzes and keep track of their progress.
  • Word Cloud: See trending subjects and discover what's popular among users.
  • Statistics: Get results instantly after a quiz, and deep dive into performance analytics.

Tech Stack

  • Frontend: Next.js 13.4, TailwindCSS, Lucide, Shadcn
  • Backend: Typescript, Prisma, OpenAI API, Next Auth, React Query
  • Database: PlanetScale (Cloud-based MySQL)

Getting Started

  1. Clone the Repository
git clone <repository_url>
  1. Install Dependencies
npm install
  1. Setup Environment Variables

Copy the `.env.example` to a new file named `.env.local` and fill in the required API keys and database credentials.

  1. Run Development Server
npm run dev

The application should now be running on http://localhost:3000/.

Contributions

We welcome contributions! Please ensure to follow the coding standards and guidelines of the project. Pull requests will be reviewed by the maintainers.

License

This project is licensed under the MIT License. See LICENSE file for more details.

Feedback & Support

For any queries, feedback or issues, please reach out to ataserb@gmail.com.

Happy Quizzing! 🚀

About

AI Quiz: Engage with quizzes via OpenAI on Next.js 13.4. Google Auth & PlanetScale DB.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published