/amigo-brain

Create a quiz about yourself and share it with your friends.

Primary LanguageTypeScript

AmigoBrain Quiz App

AmigoBrain is a fun and engaging quiz application where users can create a personalized quiz about themselves and share it with their friends. Friends can take the quiz, score themselves, and see how well they know the quiz creator. Each quiz comes with a leaderboard (Friendboard) that displays the scores of all friends who have participated.

Features

  • Create Personalized Quizzes: Users can create a quiz about themselves by selecting 10 questions from a predefined set.
  • Edit Questions & Options: Users can customize the questions and their answer options before finalizing their quiz.
  • Generate Shareable Links: After creating a quiz, users are provided with a unique link that they can share with friends.
  • Play & Score: Friends can take the quiz and receive a score based on their answers.
  • Friendboard: After playing, friends can view a leaderboard displaying the scores of others who have completed the quiz.

Technologies Used

  • Next.js: A React-based framework for server-side rendering and static site generation.
  • TypeScript: Strongly typed programming language that builds on JavaScript.
  • MongoDB: A NoSQL database used to store quiz data and user scores.
  • Tailwind CSS: A utility-first CSS framework for styling the application.
  • Shadcn UI: Component library for adding customizable and accessible UI components.
  • Acternity UI: Additional UI components integrated for enhancing the design and functionality of the app.

How It Works

  1. Create a Quiz: Users select 10 questions about themselves, customize the questions, and generate a quiz.
  2. Share the Quiz: Once the quiz is created, a shareable link is generated, which can be sent to friends.
  3. Friends Take the Quiz: Friends open the quiz link, answer the questions, and submit their answers.
  4. View Scores: After playing, friends see their score and a message based on their performance.
  5. Friendboard: The Friendboard displays the scores of all participants who have taken the quiz.

Screenshots