FlashBuddy

A standalone, single-file flashcard study app. No accounts, no tracking, no internet required — just open FlashBuddy-standalone.html and study.

Features

• Flashcards — flip through cards with keyboard shortcuts
• Learn — adaptive MC + typing rounds in spaced sections
• Test — configurable exam with multiple choice, matching, and written responses; flip terms/definitions; set question count
• Match — timed drag-and-drop matching game
• Quizlet import — import via the FlashBuddy Extras Chrome extension, PDF, or pasted export string
• Offline support — works fully offline after initial load
• Auto-update check — notifies you when a new release is posted to GitHub

Quick start

Download the latest FlashBuddy-standalone.html from the releases page and open it in any browser. That's it.

To import Quizlet decks, also grab the FlashBuddy Extras extension from the same releases page.

Docs

• How to use
• Import cards via extension
• Import cards from PDF
• Install FlashBuddy Extras
• FAQ

See CHANGELOG.md for what's new in each release.

Development

Requirements: Node.js 18+

# one-time build
npm run build

# rebuild automatically on every file change
npm run watch

Source files live in src/ — CSS in src/css/, JS in src/js/, HTML shell in src/template.html. The build script concatenates and minifies everything into a single index.html and also produces the extension zip.

Publishing a release

There are two separate releases published independently:

FlashBuddy (program)

1. Bump version in package.json
2. Update CHANGELOG.md
3. Push a v* tag — CI builds and attaches FlashBuddy-standalone.html:

git tag v2.0.1
git push origin v2.0.1

FlashBuddy Extras (extension)

1. Bump version in extension/manifest.json
2. Push an ext-v* tag — CI builds and attaches FlashBuddy-extension.zip:

git tag ext-v1.0.1
git push origin ext-v1.0.1

The download page fetches both releases from the GitHub API and displays them separately.