109 online 3 members  + Join RP Base  +
FreeScript

sbreader

by UnweidlyKhan349  ·  version 2026.11.14  ·  updated 2 days ago

No reviews yet

Downloads
0
Reviews
0
Size
32.5 MB
Code check
Checked
Licence
MIT
Released
Nov 2026

A text-based science bowl packet reader with support for both single- and multi-player.

sbreader
SB Reader: free Science Bowl practice questions, buzzer trainer and multiplayer
Open SB Reader →

SB Reader is a free practice site for the National Science Bowl (NSB) and other Science Bowl tournaments, for high school and middle school teams. It has over 100,000 real tossups and bonuses in biology, chemistry, physics, math, earth & space science and energy, taken from regional, nationals and invitational packets (MIT, Stanford, Yale and many more) and from practice sets written by school teams. Search them in the catalog, drill alone with a buzzer and automatic grading, or play against friends in an online multiplayer room. No account or install needed.

Created by Henry Lu (UnweidlyKhan349 on GitHub).

Under the hood it's a static site (a searchable catalog, a solo buzzer trainer, a peer-to-peer multiplayer mode, and starred questions kept per device) written in plain HTML/CSS/JS, with no build step, JavaScript framework or server of its own to run, so it can be deployed straight to GitHub Pages or any static host. The optional extras use a Supabase project: accounts, the Multiplayer room list and relay, and question reports, through the database schema in supabase/schema.sql, plus one small Edge Function that hands out TURN logins for Multiplayer (supabase/functions/turn-credentials). Without a project everything else still works. Its look follows QB Reader, the quizbowl reader: Bootstrap 5.3's stylesheet (from the jsDelivr CDN at a fixed version, with an integrity hash) with Light, Night and Auto themes.

Current question bank: 102,375 questions from 114 sets (55,536 tossups / 46,839 bonuses; 63,530 short answer / 38,845 multiple choice), including 567 visual questions whose figures (569 images) are shown with the question. Every question links to where it's published, and 60,162 of those links open the packet at the question's page or line.

Subject, Questions

Biology, 22,419
Earth & Space, 20,864
Physics, 19,710
Math, 16,721
Chemistry, 19,131
Energy, 4,795

This README covers what the site does, how it's built, the data format, and how to run and test it. Where the questions came from and how they were cleaned is in docs/data-history.md, the per-tournament counts are in docs/tournaments.md, and site changes are in CHANGELOG.md.

Contents
  1. Pages and features
  2. Keyboard shortcuts
  3. Answer grading
  4. Architecture
  5. Data format
  6. Visual questions
  7. Inclusion and duplicate policy
  8. Text and notation conventions
  9. Known limitations and open items
  10. Accounts
  11. Deploying
  12. Local development and tests
  13. License

Pages and features
Every page shares one navbar, laid out like QB Reader's: the SBReader wordmark, then Play (solo.html), Multiplayer, Database ▾ (Search = catalog.html, Set List) and About, with a theme menu (Light / Night / Auto) and Log in on the right (your name, once logged in). Below 992 px it folds into a ☰ menu. js/site.js, loaded in every page's `, puts the saved theme (localStorage sb_theme; Light on a first visit, Auto follows the system setting) on before the first paint, sets the browser bar colour (theme-color`) to match, so a Night page never flashes white, and wires the dropdowns, the ☰ button and the current-page highlight.
**index.html (Home)**
A welcome line and four cards, as on QB Reader's home page: the question reader (Play, Multiplayer, and a Tips & Instructions button), the question database (live question and tournament counts read from meta.json alone, with Search and Set List), the sources, and the code, changelog and licence. Once the page has loaded and the browser is idle, it prefetches the question bank's files into the browser cache at low priority, so the page you open next doesn't wait for the download (skipped when the browser reports Save-Data or a 2G connection).
**about.html (About), tips.html (Tips & Instructions) and set-list.html (Set List)**
Tips & Instructions is laid out like QB Reader's: a heading and lead line, then cards two to a row (one on a phone), each a short list: Getting Started, Searching the Database, Accounts & Progress, Help & Community, and Multiplayer. Grading and the keyboard shortcuts are on About, which it links. The home page's Sources card (a blue Tips & Instructions button, as on QB Reader) and the About page link to it.

About is laid out like QB Reader's: a lead line; paragraphs on where the packets come from (report a question, or open an issue) and contributing; then questions as headings, in QB Reader's order where they apply (Why SB Reader?, What does making an account do?, Why do I need to confirm my email?, Does it cost money?, What do I do if someone is causing trouble in a room?, Where can I request a set?, Can I get a copy of all the questions?), then How are answers graded?, What are the keyboard shortcuts? and Packet List (the Set List). Set List follows QB Reader's: a "Search set names" box (every word must appear in the name; kept in the URL as ?q=) over a table of every tournament with its level, approximate date and number of packets, tossups and bonuses, newest first; click a column heading to sort by it, again to reverse (QB Reader's filled carets mark the sorted column). The counts are stored per tournament in meta.json (count, tossups, bonuses, packets) and refreshed with node tools/meta-counts.js; a test checks they match the bank. As on QB Reader, each name opens the set's page (set.html?set=): "View here:", Back to all sets, the tournament's Source packets link (SBData.tournamentSourceUrl: a Google Drive folder a packet links to

…