ClassQuiz

 ClassQuiz 
<a href="https://github.com/mawoka-myblock/ClassQuiz/blob/master/logo.png" rel="nofollow"></a>
<p>
    The open-source quiz-platform!
    <br>
    <a href="https://classquiz.de/" rel="nofollow"><strong>Visit the website »</strong></a>
    <br>
    <br>
    <a href="https://classquiz.de/docs" rel="nofollow">Docs</a>
    ·
    <a href="https://classquiz.de/account/register" rel="nofollow">Register</a>
    ·
    <a href="https://classquiz.de/docs/self-host" rel="nofollow">Self-Hosting</a>
    ·
    <a href="https://matrix.to/#/#classquiz:matrix.org" rel="nofollow">Matrix Space</a>
</p>

About ClassQuiz

ClassQuiz is a quiz app to learn interactively for students, but open-source which is very important if it is a product for educational purposes. You can create quizzes and play them remotely with other people. It is mainly made for teachers who create a quiz, so students can compete with their knowledge against each other.

Try it

There is a hosted version at classquiz.de. The server is located in Karlsruhe, Germany and hosted by netcup, so expect some latency depending on your location.

Help/Community

Join our Matrix Space using element!

Donating

Self-Host

Please see https://classquiz.de/docs/self-host

Development

See https://classquiz.de/docs/develop

Translation

ClassQuiz uses hosted Weblate

Docs

The docs are online at https://classquiz.de/docs

Things to know about the structure

Since this repo is a monorepo, the frontend is located in the frontend/-directory. The backend-project (Pipfile) is in the root, but all the code is located in the classquiz/-folder.

Tech-Stack Backend

The backend is made with FastAPI (web-framework) , ormar (ORM) , python-socketio (realtime-communication between server and client)

Frontend

The frontend is made with SvelteKit (web-framework) and TailwindCSS (Css-Framework).

External Dependencies

Selfhostable:

• Meilisearch (Search-Server)
• Caddy (Reverse Proxy)
• Postgres (Database)
• Redis (Cache)

Closed-Source 3rd parties:

• Mapbox (maps)
• hCaptcha (captcha)

License Note

This repository is licensed under the Mozilla Public License 2.0, so you

MUST PUBLISH ANY CHANGES YOU MAKE!!!¹

Footnotes

1. I added this note, since people are stealing my software and changing it without providing the source-code. Maybe they aren't aware of this license, maybe they don't care, but I don't care, why they don't do it. THEY HAVE TO! ↩