Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rohitjuyal21/amigo-brain
Create a quiz about yourself and share it with your friends.
https://github.com/rohitjuyal21/amigo-brain
aceternity-ui mongodb nextjs shadcn-ui tailewindcss typescript
Last synced: about 1 month ago
JSON representation
Create a quiz about yourself and share it with your friends.
- Host: GitHub
- URL: https://github.com/rohitjuyal21/amigo-brain
- Owner: rohitjuyal21
- Created: 2024-10-01T18:15:34.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-10-23T18:27:37.000Z (2 months ago)
- Last Synced: 2024-10-24T04:18:30.938Z (2 months ago)
- Topics: aceternity-ui, mongodb, nextjs, shadcn-ui, tailewindcss, typescript
- Language: TypeScript
- Homepage: https://amigo-brain.vercel.app
- Size: 984 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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
