Skip to content

thm-projects/arsnova.click

Repository files navigation

DEPRECATED

This project is deprecated in favor of arsnova.click v2.

Please submit issues and feature requests of arsnova.click here: arsnova.click-v2

You can fetch the latest updates from the backend and frontend repos or use the docker images: Backend Docker and Frontend Docker


Project Vision

arsnova.click is a little bit Kahoot! and a little bit ARSnova.

While Kahoot! is a small game-based audience-response app for schools, ARSnova is a full-grown innovative audience-response platform for colleges and universities.

arsnova.click is somewhere in the feature range of both:

Landing Page

  • It is a free competition-based quiz webapp
  • Everybody may create and play quizzes, as many as you like, at any time
  • One landing page for both roles: quizmaster and candidate
  • You don't have to register, sign-in, install an app, or pay for the service
  • It offers a Markdown user interface for text formatting
  • It offers LaTeX and syntax highlighting for questions and answer options, so that it is well appropriate for quizzes in maths, physics, and informatics
  • It is Open Source under GNU General Public License version 3
  • It is very responsive: from smartphone to widescreen, and very beamer-friendly
  • It takes privacy to the extreme: no data is stored on a server, everything is in the HTML5 WebStorage of the quizmaster's browser
  • It is at the peak of open-source web technology: Meteor and Bootstrap

Getting started

To run arsnova.click on your own Node.js-Server, at least a MongoDB and Meteor is needed. Furthermore, an HTTPS-Proxy-Server (for example Nginx) is highly recommended.

Hardware Resources

Up to a amount of 100 users, we are recommending:

  • 1 CPU-Core
  • 1 GB of RAM
  • 4 GB of free disk-space for the database

For 100+ users, we recommend:

  • 2 CPU-Cores
  • 2 GB of RAM
  • 4 GB of free disk-space for the database

Development

Our application uses Meteor as application framework. Download and install Meteor to get arsnova.click running on your local development environment.

You can start the app using the meteor --settings settings.json command in the main directory, the application will rebuild itself automatically on code changes. Get additional informations through the official Meteor Guide and its API-Documentation.

For code-checking we use jshint.

Code Inspection

We use SonarQube to continuously check the quality and technical debts of our repo.

Build & Deploy

We continuously integrate, sync with GitHub, and deploy to staging and production evironments with GitLab CI.

build status