quizzly - GitLite

KO | EN

gitlite — search

#codex #docker #nlp #git #security #http #database #kotlin #github #reactjs

quizzly

(★ 9)

Live multiplayer quiz app on Frappe. Guests join by PIN or QR, no login, server-authoritative gameplay.

파일 탐색기

ZIP 다운로드

- - ci.yml
  - linter.yml
- - host-leaderboard.png
  - host-lobby.png
  - host-podium.png
  - host-question.png
  - player-answer.png
  - player-join.png
  - quiz-editor.png
  - theme.png
- load-testing.md
- - build-avatars.mjs
- - api.js
  - App.vue
  - avatars.js
  - confirm.js
  - game.js
  - index.css
  - main.js
  - nicknames.js
  - player.js
  - router.js
  - socket.js
  - sound.js
  - theme.js
- auto-imports.d.ts
- components.d.ts
- index.html
- join-dark.png
- package.json
- postcss.config.js
- tailwind.config.js
- vite.config.js
- yarn.lock
- - notionists.json
- - role.json
- - __init__.py
- - .gitkeep
- - .frappe
  - __init__.py
- - __init__.py
  - test_api.py
  - test_authoring.py
  - test_avatars.py
  - test_engine.py
  - test_game_ux.py
  - test_nicknames.py
- - quizzly.py
- __init__.py
- api.py
- avatars.py
- engine.py
- hooks.py
- modules.txt
- nicknames.py
- patches.txt
- profanity.py
- handlers.js
- package.json
- check_guest_socket.cjs
- demo_bots.py
- loadtest.py
- loadtest.sh
- loadtest_setup.py
- prompt.md
- ralph.sh
- seed_demo.py
- - phase-1-ticker-tracer.md
  - phase-2-multi-game-scale.md
  - phase-3-batch-scoring.md
  - phase-4-submit-and-count.md
  - README.md
- live-quiz-flow.md
- live-quiz-latency-rework.md
- phase-0-foundation-spike.md
- phase-1-content-session-shell.md
- phase-10-answer-explanation.md
- phase-11-quiz-preview.md
- phase-12-scoreboard-screen.md
- phase-2-game-engine.md
- phase-3-game-ux.md
- phase-4-juice.md
- phase-4a-content-authoring.md
- phase-4b-host-conveniences.md
- phase-4c-player-fun.md
- phase-4d-game-modes.md
- phase-5-visual-identity.md
- phase-6-navigation.md
- phase-7-avatar-carousel.md
- phase-8-ci.md
- phase-9-documentation.md
.editorconfig
.eslintrc
.gitignore
.pre-commit-config.yaml
CLAUDE.md
license.txt
package.json
plan.md
progress.md
pyproject.toml
README.md

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="center">

**Live multiplayer quiz, no login required**

<img alt="Host lobby with the game PIN, QR code and players joining" src="docs/images/host-lobby.png" />

</div>

## What it is

Quizzly is a live quiz game built on the Frappe Framework. A host puts the game
PIN on the big screen, players join from their phones with the PIN or by
scanning the QR code, and nobody needs an account.

Gameplay is server-authoritative. The correct answer never reaches a player's
device before the question closes, scores are computed from a server-set
deadline, and every submission is validated against the server's own view of
the game.

<details>
<summary>Screenshots</summary>

**Joining from a phone**

<img alt="Join screen with PIN, nickname suggestions and avatar picker" src="docs/images/player-join.png" width="320" />

**A question, live on both screens**

<img alt="Host screen showing a question, countdown and answer count" src="docs/images/host-question.png" />

<img alt="Player screen showing four coloured answer buttons" src="docs/images/player-answer.png" width="320" />

**Between questions**

<img alt="Correct answer revealed with answer distribution and top five leaderboard" src="docs/images/host-leaderboard.png" />

**Final results**

<img alt="Podium with the top three players and the full leaderboard" src="docs/images/host-podium.png" />

**Writing a quiz**

<img alt="Quiz editor with question text, four options and the correct answer marked" src="docs/images/quiz-editor.png" />

**Light and dark**

<img alt="Player question screen in dark theme" src="docs/images/theme.png" width="320" />

</details>

## Features

- Guests join with a PIN or QR code, no account and no app install
- Live lobby: names appear as players join, host can lock it or kick anyone
- Questions land on every device at once, with a per-question timer
- Speed-scaled scoring with streak bonuses, in the style of the games it borrows from
- Answer distribution, correct answer reveal and top-five leaderboard between questions
- Top-three podium at the end, plus the full ranking
- Avatar picker and nickname suggestions for players
- Light and dark theme, everywhere
- Quizzes are written in the app, no Desk trip needed

## Under the hood

- [Frappe Framework](https://github.com/frappe/frappe) for the backend, DocTypes and permissions
- [Vue 3](https://vuejs.org) and [frappe-ui](https://github.com/frappe/frappe-ui) for the single-page app
- [Socket.IO](https://socket.io) to push every state change to hosts and players
- Redis for the hot session state each answer is validated against
- RQ for the single shared ticker that drives every live game loop

## Development setup

1. Set up a bench by following the
   [installation steps](https://frappeframework.com/docs/user/en/installation)
   and start the server with `bench start`.

2. In another terminal, from your bench directory:

```bash
bench get-app https://github.com/gajjug004/quizzly --branch develop
bench --site your-site.localhost install-app quizzly
```

The app is served at `/quizzly` on your site. For frontend work, run the Vite
dev server against it:

```bash
cd apps/quizzly/frontend
yarn install
yarn dev
```

## Testing

```bash
bench --site your-site.localhost set-config allow_tests true
bench --site your-site.localhost run-tests --app quizzly
```

## Contributing

This app uses `pre-commit` for code formatting and linting. Please
[install pre-commit](https://pre-commit.com/#installation) and enable it for
this repository:

```bash
cd apps/quizzly
pre-commit install
```

Pre-commit is configured to use ruff, eslint, prettier and pyupgrade.

`plan.md` holds the build plan and architecture, `specs/` holds the spec for
each phase, and `progress.md` logs what was actually built.

## License

MIT