Flashcards

A Quizlet-style flashcard study app: create decks, study them in four modes (flip / multiple-choice / typed / spaced repetition), import existing Quizlet sets, and generate cards from your own study materials using Claude.

Stack

• Frontend: Vite + React + Tailwind, React Router
• Backend: Node.js + Express, SQLite (better-sqlite3), JWT auth
• AI: Anthropic Claude API (claude-sonnet-4-6) via @anthropic-ai/sdk

Setup

npm run install:all

Create server/.env:

ANTHROPIC_API_KEY=sk-ant-...
JWT_SECRET=change-me-in-production

(ANTHROPIC_API_KEY is only needed for the "Generate from study material" feature; everything else works without it.)

Run

npm run dev

This starts the API on http://localhost:4000 and the Vite dev server on http://localhost:5173. The dev server proxies /api/* to the backend, so open http://localhost:5173.

Features

• Auth — email/password, JWT in localStorage
• Decks & cards — full CRUD
• Flip mode — 3D flip animation, shuffle, prev/next
• Quiz mode — auto-generated multiple choice (distractors pulled from other cards)
• Typed mode — case/whitespace-insensitive answer check
• Spaced repetition — SM-2 style scheduling with Again / Hard / Good / Easy buttons
• Quizlet import — paste exported text with configurable delimiters
• AI generation — paste text or upload .txt / .pdf / .docx; pick beginner / intermediate / advanced; Claude generates 5–50 cards

Engineering principles

Every feature is planned in a GitHub issue before implementation. Releases get a git tag plus a GitHub Release.

See issue #1 for the v1 plan.