Hecz study lab

Official study app. Open-source lab.

The production app is the curated Hecz study experience. The public repo is the starter kit for people who want to fork it, build their own question bank, and run a local class lab.

hecz / study preview

Production

Curated Hecz study app

Use this when the goal is studying with the official bank and app behavior.

  • Bank import is locked unless explicitly enabled.
  • Official content remains the default experience.
  • Learners should start with Practice, Review, Flashcards, and Compete.

Lab / fork

Build your own bank

Use this when the goal is teaching, remixing, or creating a personal/classroom question bank.

  • Local development enables import automatically.
  • Deployed forks can set NEXT_PUBLIC_ENABLE_BANK_IMPORT=true.
  • Students bring allowed notes, labs, and source-checked resources.

First lab run

The workflow is intentionally small.

notes -> bank -> practice -> misses -> better explanations
  1. Fork or clone the public starter.
  2. Pick one narrow topic.
  3. Write five original questions and three flashcards.
  4. Import locally, run a short session, and revise weak explanations.

Share with class

One scan gets everyone to the lab.

Use this for a class demo, study group, or project showcase. The public repo stays clean; the official production app keeps its curated bank locked.

QR code for https://study.hecz.dev/lab

study.hecz.dev/lab

Short path for slides, Discord, classroom screens, and phone sharing.

Demo bank walkthrough

Start with five questions before building a full bank.

This keeps the first lab realistic: students learn the content loop and source discipline before they try to create hundreds of items.

01

Pick a narrow topic

Example: TCP vs UDP, not all of networking.

02

Write five original MCQs

Each question needs one best answer and explanations for the distractors.

03

Add three flashcards

Use these for exact facts, port numbers, acronyms, or short definitions.

04

Track allowed sources

Use class notes, labs, official objectives, and resources you have permission to reuse.

05

Import, miss, revise

Run the bank locally, review misses, then rewrite weak explanations before adding more.

Starter kit

Share one page, not scattered links.

Fork the public starter

Start from the clean open-source repo.

Download the class pack

JSON, CSV, source checklist, and peer-review checklist.

Open the brand deck

hecz.dev-style starter-kit presentation.

Open the classroom deck

Structured version for instructors and class sessions.

Read the changelog

Recent product and public starter updates.

Reference

Docs for instructors and builders.

Build your bank

Question-writing rules and source hygiene.

Import format

CSV and JSON shape for local/forked labs.

Class lab handout

Timing, rubric, and student deliverables.