StudyDeck (LEARNING TOOL)

A complete, local, zero-install flashcard study app — all the study modes you know (Flashcards, Learn, Write, Test, Match), with sound effects, progress tracking, and CSV import so Claude can build sets for you from any PDF or notes.

Everything runs in your browser and is stored in localStorage. No accounts, no server, no internet needed.

How to run

Just open index.html in your browser (double-click it, or right-click → Open with → Chrome/Edge).

Tip: pin it — drag index.html onto your bookmarks bar.

A sample set ("World Capitals") is preloaded so you can try every mode immediately.

Study modes

Mode	What it does
Flashcards	Flip cards (click or Space), navigate with ←/→, shuffle, autoplay, star cards, read-aloud (A), and an optional sort mode where you mark each card know / still learning and re-review the ones you missed.
Learn	Adaptive rounds of 5 questions. Each term starts as multiple choice, and the moment you answer it correctly it's promoted to a written question mixed back into the same round (Quizlet-style) — so writing never waits until all the MCQs are done. Mastered after two correct answers. Miss any question — MC or written — and it stops, shows the correct answer and any card notes, and waits for a Continue (or any key) before moving on; the term is re-queued. Answer with the definition, term, or both. Written misses include "✓ I was correct" to override. A 🔥 streak fire grows as you chain correct answers, and best-streak trackers (overall / MC / written) are saved. Optional 🍅 Pomodoro locks studying into timed focus/break intervals. Checkpoints show Mastered / Familiar / Not studied; progress is saved between sessions.
Write	Type the answer for every card. Miss one and you'll see the correct answer and copy it to continue (that's how it sticks!). Missed terms roll into the next round until you've written everything correctly. Includes "Override: I was correct".
Test	A graded practice exam: choose the number of questions and mix of written / matching / multiple choice / true-false, answer with term, definition, or both. Auto-graded with a score ring and full answer review. Printable.
Match	The classic race: 6 pairs scattered on a board — clear it as fast as you can. Wrong matches add +1 second. Your best time per set is saved.

Smart grading (toggle in any mode's options): small typos in written answers still count, answers in parentheses are optional, and ;//-separated alternatives are each accepted.

Per-card notes & custom multiple-choice options

Every card has two optional extras (edit them under "Notes & MCQ options" on any card in the set editor, or import them straight from CSV):

• Notes — a hint, mnemonic, or deeper explanation. It stays locked (🔒) until you answer the card in Learn, so you can't cheat yourself, then reveals with the result.
• Custom MCQ decoys — up to three wrong answers specific to that card. Learn and Test use them as the multiple-choice options instead of random pulls from the set, so the choices are all same-category and the correct one isn't an obvious giveaway. Leave them blank and the app falls back to random decoys.

Sound & speech

• Synthesized sound effects for flips, correct/incorrect answers, matches, streaks, round completions, and fanfares (Web Audio — no audio files). Toggle with the speaker icon in the header.
• Text-to-speech "read aloud" on cards and term lists (uses your OS voices).

Make flashcards from a PDF with Claude

This is the killer workflow:

1. Give Claude your PDF / lecture notes / textbook chapter along with the ready-made prompt — click "🤖 Copy Claude prompt" in the import panel of any set editor, or copy this:

   I'm giving you some study material (PDF, notes, slides, or a topic). Turn it into
   flashcards I can import into my study app.
   
   Rules:
   1. Cover EVERY key concept, definition, formula, date, and fact — don't skip anything important.
   2. Output a CSV file (or code block) with this exact header row:
      term,definition,notes,distractor1,distractor2,distractor3
   3. One row per card. Wrap EVERY field in double quotes. Escape inner quotes by doubling them ("").
   4. "term" = a short question or keyword. "definition" = the complete, concise answer.
   5. "notes" = an optional extra tip, mnemonic, or deeper explanation shown only AFTER the card is answered (leave "" if none).
   6. distractor1-3 = three plausible but WRONG answers specific to THIS card, used as multiple-choice decoys.
      - Make them believable and same-category as the real answer (not obviously wrong), so the correct option isn't a giveaway.
      - They must be wrong for this exact question. Leave "" if you can't make good ones (the app will fall back to random decoys).
   7. Prefer many small atomic cards over few big ones. Aim for 20-60 cards depending on the material's density.
   8. If you're running in Claude Code, save the result as flashcards.csv.
   
   Example row:
   "What organelle is the powerhouse of the cell?","Mitochondria","Makes ATP via cellular respiration.","Ribosome","Golgi apparatus","Nucleus"
   
   Here is the material:
   

2. Claude returns a CSV (or saves flashcards.csv if you're in Claude Code).

3. In StudyDeck: + Create set → paste the CSV into the import box (or Choose file…, or just drag the .csv onto the page) → Add to set → Create.

4. Study. That's it — PDF to flashcards in under a minute.

Accepted import formats

• CSV — term,definition header optional; quoted fields, commas and newlines inside quotes all handled
• CSV with extras — add a header row and include notes and/or distractor1…distractorN columns (any order) to import per-card notes and custom MCQ decoys; columns are matched by name
• TSV — term<TAB>definition per line (what you get copying from Excel/Sheets)
• Custom separators — e.g. term - definition per line, or term,definition; rows
• Auto-detect figures out tabs vs. commas vs. term - definition for you

Try it now with the included sample-import.csv.

Every set can also be exported back to CSV (button on the set page), so your data is never locked in.

Keyboard shortcuts

Key	Action
Space	Flip card / continue
← →	Previous / next card (or Still learning / Know in sort mode)
S	Star current card
A	Read card aloud
1–4	Pick a multiple-choice answer
Enter	Submit written answer / continue

Where's my data?

In your browser's localStorage under the keys studydeck.sets and studydeck.settings. It persists between sessions on the same browser + machine. Use Export CSV for backups.

OPEN INSTRUCTION.MD FOR SETUP GUIDE