Skip to content

feat: Educational quiz — learn Solana with 1001 terms#17

Open
ojonassa wants to merge 1 commit intosolanabr:mainfrom
ojonassa:feat/quiz
Open

feat: Educational quiz — learn Solana with 1001 terms#17
ojonassa wants to merge 1 commit intosolanabr:mainfrom
ojonassa:feat/quiz

Conversation

@ojonassa
Copy link
Copy Markdown

@ojonassa ojonassa commented Apr 3, 2026

What this PR adds

An interactive educational quiz built from the full 1001-term Solana Glossary.

Features

  • Dynamic questions from any combination of the 14 categories
  • Multiple choice — 4 options per question (1 correct + 3 distractors from the full dataset)
  • Instant feedback — correct/incorrect highlighted immediately after each answer
  • Scoring — percentage score + average answer time
  • Review mode — see every question with your answer vs the correct answer
  • Terms to study — missed terms listed with their definitions after the quiz

Live demo

https://quiz-flame-two.vercel.app

Stack

  • React 18 + TypeScript + Vite
  • Tailwind CSS v4 (via @tailwindcss/vite)
  • @stbr/solana-glossary for the question bank
  • Fisher-Yates shuffle for random question and distractor selection

Built by Superteam Brazil for the Solana Glossary Bounty.

Interactive quiz game built from the full Solana Glossary.
Multiple choice, instant feedback, scoring, and review mode.

Live demo: https://quiz-flame-two.vercel.app
@kauenet
Copy link
Copy Markdown
Contributor

kauenet commented Apr 4, 2026

This is really cool, I love it! I believe we can use it on pushing education in Brazil, could you just prepare your project for it?

Things like multi lang support, share button for results, maybe even minting NFTs for results or something like that would be really cool! Think outside the box, the core idea is solid, as well as initial execution, but I know you can expand and improve this.

@kauenet
Copy link
Copy Markdown
Contributor

kauenet commented Apr 4, 2026

Also make the non-correct options a bit less obviously uncorrelated, so it adds to the challenge.

@ojonassa
Copy link
Copy Markdown
Author

ojonassa commented Apr 4, 2026

Hey @kauenet, thanks for the awesome feedback! I've shipped all the improvements:

1. Smarter distractors (more challenging quiz) ✅
Wrong answers now use a 3-layer priority system:

  • 1st: Terms from the same category as the question
  • 2nd: Terms from semantically related categories
  • 3rd: Global pool as fallback

2. Share button ✅
Web Share API on mobile, clipboard fallback on desktop.

3. Multi-language support — 8 languages ✅
🇺🇸 English | 🇧🇷 Português | 🇪🇸 Español | 🇫🇷 Français | 🇩🇪 Deutsch | 🇹🇷 Türkçe | 🇯🇵 日本語 | 🇰🇷 한국어

Full UI translated for each language: titles, buttons, categories, results, share messages. Language selector with flags available on all screens.

A note on term definitions: The quiz displays definitions in the selected language when available in the @stbr/solana-glossary package. Currently, 151/1001 terms have Portuguese translations — the remaining terms display in English as provided by the SDK. As the package receives more translations, the quiz will automatically reflect them with zero code changes needed.

I chose these 8 languages specifically because they a

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants