Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/joozef315/regista-football-quizzes
Regista is an interactive NestJs platform designed for football enthusiasts, offering challenging quizzes to test your knowledge of the beautiful game.
https://github.com/joozef315/regista-football-quizzes
football football-players game mongodb mongoose nextjs quiz-game tailwindcss zustand
Last synced: about 2 months ago
JSON representation
Regista is an interactive NestJs platform designed for football enthusiasts, offering challenging quizzes to test your knowledge of the beautiful game.
- Host: GitHub
- URL: https://github.com/joozef315/regista-football-quizzes
- Owner: JooZef315
- License: mit
- Created: 2024-09-01T23:43:22.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2024-10-12T18:54:34.000Z (3 months ago)
- Last Synced: 2024-10-16T18:57:54.819Z (3 months ago)
- Topics: football, football-players, game, mongodb, mongoose, nextjs, quiz-game, tailwindcss, zustand
- Language: TypeScript
- Homepage: https://regista-football-quizzes.vercel.app
- Size: 602 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ⚽ Regista Football Quizzes
Welcome to **Regista Football Quizzes**! This is a competitive football quiz app where users can play in different modes, test their knowledge about football, and see how well they score against others.
## 🌍 Play It Live!
You can play the **Regista Football Quizzes** right now! Just click the link below to start challenging yourself and others in various football quiz modes:
[Play Live Now!](https://regista-football-quizzes.vercel.app/)
## 🛠️ Technologies
- **Next.js 14**: Full-stack React framework with support for server-side rendering (SSR) and new App Router features.
- **Tailwind CSS**: Utility-first CSS framework for rapid UI development.
- **Zustand**: State management for easily managing player and game states.
- **React Hook Form**: Form handling with validation, focusing on minimal re-renders.
- **Mongoose**: Object Data Modeling (ODM) for MongoDB.
- **Vercel**: Hosting platform for serverless deployment of the Next.js app.
## 🚀 Features
- Play single or team-based football quiz games.
- Switch between categories and levels of difficulty.
- Real-time state management with **Zustand**.
- Dynamic forms and validation powered by **React Hook Form**.
- Database-backed question and feedback systems via **Mongoose**.
- Hosted on **Vercel** for fast, reliable deployment.
## 🖥️ Getting Started
### Prerequisites
Ensure you have the following installed on your system:
- [Node.js](https://nodejs.org/) (v16.x or higher)
- [MongoDB](https://www.mongodb.com/) (either local or Atlas)
### Installation
1. Clone the repository:
```bash
git clone https://github.com/JooZef315/Regista-Football-Quizzes.git
```
2. Navigate to the project folder:
```bash
cd Regista-Football-Quizzes
```
3. Install dependencies:
```bash
npm install
```
4. Set up environment variables:
Create a .env.local file in the root of the project and add the following:
```bash
DATABASE_URI=
```
5. Development Mode:
```bash
npm run dev
```
Open http://localhost:3000 to view it in the browser.
## License
This project is licensed under the [MIT licensed](LICENSE).