{"id":20253978,"url":"https://github.com/frectonz/quizzy","last_synced_at":"2025-04-10T23:43:49.324Z","repository":{"id":249216167,"uuid":"828795428","full_name":"frectonz/quizzy","owner":"frectonz","description":"A simple dockerized configurable self-hostable quiz app that uses a libSQL database from Turso.","archived":false,"fork":false,"pushed_at":"2025-03-14T13:39:40.000Z","size":197,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-10T23:43:42.885Z","etag":null,"topics":["docker","libsql","picocss","quiz-app","rust"],"latest_commit_sha":null,"homepage":"https://quizzy-app-ytx7.onrender.com/quiz/1","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/frectonz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-15T06:31:51.000Z","updated_at":"2025-03-14T13:39:43.000Z","dependencies_parsed_at":"2024-07-19T11:26:12.877Z","dependency_job_id":"f32f9b34-bc5e-41fd-8c73-9a31328f1034","html_url":"https://github.com/frectonz/quizzy","commit_stats":null,"previous_names":["frectonz/quizzy"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frectonz%2Fquizzy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frectonz%2Fquizzy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frectonz%2Fquizzy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frectonz%2Fquizzy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/frectonz","download_url":"https://codeload.github.com/frectonz/quizzy/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248317726,"owners_count":21083527,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","libsql","picocss","quiz-app","rust"],"created_at":"2024-11-14T10:29:05.623Z","updated_at":"2025-04-10T23:43:49.302Z","avatar_url":"https://github.com/frectonz.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# quizzy\n\nA simple dockerized configurable self-hostable quiz app that uses a `libSQL` database from [Turso](https://turso.tech/).\n\nOne thing that makes `quizzy` special is that quizzes are imported not through inputs and forms but from one JSON file that has all the questions. Here's an example of a quiz with 3 questions taken from the book 1984.\n\n```json\n[\n  {\n    \"question\": \"What is the uniform of the party?\",\n    \"options\": [\n      { \"text\": \"Green Overalls\", \"isAnswer\": false },\n      { \"text\": \"Blue Overall\", \"isAnswer\": true },\n      { \"text\": \"Yellow Overalls\", \"isAnswer\": false }\n    ]\n  },\n  {\n    \"question\": \"What is the language of Oceania?\",\n    \"options\": [\n      { \"text\": \"Newspeak\", \"isAnswer\": true },\n      { \"text\": \"Oldspeak\", \"isAnswer\": false },\n      { \"text\": \"OceaniaSpeak\", \"isAnswer\": false }\n    ]\n  },\n  {\n    \"question\": \"What happens to people accused of Thoughtcrime?\",\n    \"options\": [\n      { \"text\": \"KILLED\", \"isAnswer\": false },\n      { \"text\": \"BOILED\", \"isAnswer\": false },\n      { \"text\": \"VAPORIZED\", \"isAnswer\": true }\n    ]\n  }\n]\n```\n\nSample quizzes for [1984](https://github.com/frectonz/book-quizes/tree/main/quizes/1984) and [The Hitchhiker's Guide to the Galaxy](https://github.com/frectonz/book-quizes/tree/main/quizes/hitchhiker's-guide-to-the-galaxy) are available.\n\n## Demo\n\nhttps://github.com/user-attachments/assets/4904b249-da95-4e08-b20a-45f25ed7f779\n\n## Technologies\n\n- [PicoCSS](https://picocss.com)\n- [libSQl](https://github.com/tursodatabase/libsql)\n- [Nix](https://nixos.org/)\n- [HTMX](https://htmx.org/)\n\n## Local Installation\n\n### Install prebuilt binaries via shell script (MacOS and Linux)\n\n```sh\ncurl --proto '=https' --tlsv1.2 -LsSf https://github.com/frectonz/quizzy/releases/download/0.1.2/quizzy-installer.sh | sh\n```\n\n### Install prebuilt binaries via powershell script (Windows)\n\n```sh\npowershell -c \"irm https://github.com/frectonz/quizzy/releases/download/0.1.2/quizzy-installer.ps1 | iex\"\n```\n\n### Updating\n\n```bash\nquizzy-update\n```\n\n## Nix\n\n```bash\nnix shell github:frectonz/quizzy\n```\n\n## Using the docker image\n\nThe docker image is available on the [Docker Hub](https://hub.docker.com/r/frectonz/quizzy). You can use this docker image to deploy `quizzy` on any platform you want.\n\n```\ndocker pull frectonz/quizzy\ndocker run -p 1414:1414 \\\n      -e ADDRESS=\"0.0.0.0:1414\" \\\n      -e URL=\"libsql://\u003cname\u003e.turso.io\" \\\n      -e AUTH_TOKEN=\"\u003ctoken\u003e\" \\\n      frectonz/quizzy\n```\n\n### Environment variables\n\n- `ADDRESS` - the address to bind to, example `0.0.0.0:1414`\n- `URL` - libSQL server address from Turso, example `libsql://my-quiz.turso.io`\n- `AUTH_TOKEN` - libSQL authentication token from Turso, must support read and write actions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrectonz%2Fquizzy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffrectonz%2Fquizzy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrectonz%2Fquizzy/lists"}