Open-Source Quizzing Built for Live Engagement

jovVix

• jovVix is a fun and interactive platform where users can enjoy playing quizzes while admins have the ability to create engaging and diverse quizzes.

• Designed to provide a fun and educational experience while ensuring smooth admin management, jovVix is the perfect solution for interactive quiz-based learning, competitions, or corporate events.

• App is an interactive, real-time platform that supports diverse question types like

• App provides instant feedback and live ranks and leaderboards. With features like

  • In-depth analytics
  • real dynamic avatars
  • customizable csv with different question types like: Image based, code based, survey based questions
    
    

Live Demo & Website

• Website: Visit https://jovvix.com to learn more about the platform, explore the About section, and access full Documentation.
• Live Demo: Try out the platform live at https://app.jovvix.com to experience how the quiz system works — including joining a quiz, answering questions in real-time, and viewing live leaderboards.

Key Attributes:

• Cloud-Based: The application can be deployed on cloud platforms, providing high availability and scalability for users and organizations.
• Environment Agnostic: Compatible with multiple environments (local, development, staging, and production) for seamless deployment across setups.
• Cross-Platform: Designed for a smooth experience across devices and operating systems.
• Modular Architecture: Built with a component-based architecture, enabling high code reusability and scalability.
• Real-Time Features: Uses WebSockets for real-time communication and user interaction.

Development and Quality

• Linting: Utilizes ESLint to maintain code quality and consistency.
• Authentication: Ory Kratos manages secure user authentication and session management.
• Image Handling: Images for questions and options are stored inline as base64 in PostgreSQL, removing the need for any external object-storage service.
• SMTP Services: Configured for email services, supporting verification and password recovery.
• Testing: We have performed the unit testing in this application
• Containerization: Packaged with Docker for streamlined deployment and environment consistency.
• RESTful API: Offers a RESTful API for integration and easy access to app functionality.
• Environment Variables: Follows the 12-factor app principles with environment variable configuration.

User Experience

• Intuitive UI/UX: Designed for a user-friendly and engaging interface.
• Gamification: Includes elements like points, ranks, and leaderboards to boost user engagement.

Features

• Real-time Interaction: Supports real-time quizzes with instant feedback and live leaderboards, ensuring a highly engaging user experience.
• Multiple Question Types: Allows admins to create quizzes with different question formats:
  • Multiple-choice questions
  • Survey-based questions
  • Code-based challenges
  • Image-based questions
• In-Depth Analytics: Provides detailed insights and analytics for both users and admins, including answer breakdowns and performance tracking.
• Reports-Dashboard: Provides an in depth metrices of user's response to admin and user analysis statistics
• Dynamic Avatars: Real-time avatar updates for users in various stages:
  • When joining and waiting for a quiz
  • During the quiz at each question
  • After the quiz, showcasing winners and individual performance
• Customization Options: Offers customizable quiz features for educators, workshop hosts, and event organizers to suit their needs.
• Share quiz feature Users can share their quiz to other users through email and can grant their preferred permission while sharing to the other one
• CSV Uploads: Enables efficient quiz creation through CSV file uploads, allowing users to preview, edit, and allowing users to seamlessly create quizzes
  • You can see the CSV formatting guidelines here : csv-formatting-guide.md
• Mobile-Friendly Design: Fully responsive and works seamlessly on mobile and desktop devices.
• Admin Tools: Advanced admin panel for managing quizzes, participants, and results.
• API Documentation with Swagger: Provides a visual interface for exploring API endpoints and testing requests, Useful for developers working with the API
• Open Source: Fully open-source platform, allowing developers to contribute, customize, and extend the app.

Table of Contents:

• About jovVix
  • Quickstart
• Features
• Getting started
  • Local setup
• Documentation
  • Architecture Overview
  • Overview of API documentation
  • Upgrading and changelog
• Contributing to jovVix
• Code Of Conduct
• [Develop]()
  • Guide
  • Adding shadcn-vue Components
  • Collaborators
  • Dependencies

Prerequisites

• Docker latest version installed in your system

Quickstart

Important: Ensure all the tools mentioned in the prerequisites are installed before proceeding.

• First clone the repository on your terminal using command given below

  git clone https://github.com/improwised/jovVix.git

• Navigate to the project directory using:

   cd jovVix

• Configure your env settings into .env.docker if you want to integrate any changes otherwise keep the default ones

• Then build and run the docker compose file in your environment by following command

  docker-compose up --build

• Your app is now running successfully and you can access it on the ip:port as :

  127.0.0.1:5000

• For verification of email go to mailpit localhost and port

  127.0.0.1:8025

Getting Started For local setup from source

Prerequisites

• jovVix is a fun and interactive platform where users can enjoy playing quizzes while admins have the ability to create engaging and diverse quizzes.

Installation steps

Important: Ensure all the tools mentioned in the prerequisites are installed before proceeding.

• First clone the repository using

  git clone https://github.com/Improwised/jovVix.git

• Navigate to the project directory:

   cd jovVix

• Then Copy environment files of both app and api folders using:

   cp api/.env.example api/.env
   cp app/.env.example app/.env

• Start backend services:

  cd api
  docker-compose up
  go run app.go migrate
  go run app.go api

Warning Install all tools and technologies we have mentioned above in prerequisites

• Then Install frontend dependencies:

  cd ../app
  npm install

• Afterwards run the frontend development server:

  npm i
  npm run dev

• Then you have setup jovVix successfully in your local environment

• Designed to provide a fun and educational experience while ensuring smooth admin management, jovVix is the perfect solution for interactive quiz-based learning, competitions, or corporate events.

Documentation

Architecture Overview:

System Architecture

• Backend: jovVix uses a Golang backend to handle the server-side logic.
• Frontend: Vue.js and nuxt framework is employed for a single-page application (SPA) architecture and component-based development.
• Database: PostgreSQL is used to handle concurrent requests and manage data efficiently.
• Caching: Redis is utilized for caching and manipulating users' data and requests, improving performance.
• Authentication: The app leverages Ory Kratos for user authentication and uses SMTP services for password recovery and email verification flows.
• Real-Time Communication: WebSockets are implemented for handling multiple sessions and managing cookies effectively.
• Base64: We are storing images as base64

API Overview:

• locally you could start your API server by running the following command :

  http://127.0.0.1:3000/api/v1/docs

• This would open the swagger documentation

• Backend: jovVix uses a Golang backend to handle the server-side logic.

• This would open the swagger documentation

Upgrading and changelog:

• It's being managed in this file: CHANGELOG.md

Contributing to jovVix:

• You can see the contribution guidelines here : CONTRIBUTING.md

Code of Conduct:

• This platforms also provides the Code of Conduct

Developer

Guide:

If you're a developer looking to contribute or modify jovVix, here is a brief guide to get started: Getting started OR, you could just docker-compose up

Code Structure Overview:

• app/: Contains Vue.js components for the quiz interface and holds frontend pages and all
• api/: Contains Golang source code for the server-side logic.

Adding shadcn-vue Components:

• This project is configured with shadcn-vue via the shadcn-nuxt module (version 2.2.0). The configuration lives in app/components.json and uses the new-york style with the neutral base color and the lucide icon library.
• To add a new component to the project, run the shadcn-vue CLI from inside the app/ directory:

  cd app
  npx [email protected] add <component-name>

• For example, to add the button component:

  npx [email protected] add button

• The CLI reads components.json and installs the component into app/components/ui/<component-name>/ using the aliases defined in that file (@/components/ui, @/lib/utils, etc.).
• Please pin to version 2.2.0 of the CLI when adding components so that generated code stays consistent with the rest of the project. If you need to upgrade the CLI/module, bump both shadcn-nuxt in app/package.json and the version used in the command above in the same PR.
• For the full list of available components and their usage, refer to the shadcn-vue documentation.

Collaborators:

• Thanks to all the people who already contributed!

Dependencies:

This project uses the following key dependencies:

• Frontend:

  • Vue.js: For building reactive user interfaces.
  • Nuxt 3: Framework for server-side rendering and static site generation.

• Backend:

  • Go (Golang): High-performance backend logic.
  • PostgreSQL: Relational database management.

• Other Tools:

  • Redis: Used for caching and session management.
  • Ory Kratos: For user authentication.
  • mailpit setup locally for the SMTP like server

Design & Image Credits

• The jovVix logo is designed by Nirav Raval.
• All other images and visual assets used in the platform are either custom-designed or sourced from Freepik under their free license.

Note: Assets from Freepik are used in accordance with their license terms.

License:

jovVix is put under a dual-licensing scheme: In general all of the provided code is open source via GNU AGPL 3.0, please see the LICENSE file for more details.