Initial release of WortKraft German A2/B1 learning studio

README.md

@@ -0,0 +1,17 @@
+# WortKraft — Active German A2/B1 Vocabulary & Context Studio
+
+**WortKraft** is a self-hosted German learning application built to bridge the "1,400-day Duolingo plateau" by transitioning from passive multiple-choice recognition to **active recall, grammatical gender mastery (`der`/`die`/`das`), contextual reading, and targeted sentence production**.
+
+## Core Features
+- **⚡ Wortschatz-Trainer (SM-2 Spaced Repetition)**:
+  - **Lückensatz im Kontext**: Fill in the missing German word in realistic A2/B1 sentences.
+  - **Aktiv Schreiben (EN → DE + Artikel)**: Active recall of both the German word and its grammatical gender (`der`, `die`, `das`).
+  - **Artikel & Plural-Blitz**: Rapid-fire noun gender and plural drill with morphological suffix rules.
+  - **Karteikarte & Wortbau**: Compound word and prefix breakdowns with `de-DE` native speech synthesis.
+- **📖 Interaktive Leseecke (Graded Reader)**:
+  - Pre-loaded practical everyday German scenarios (*Bürgeramt, Arztpraxis, Feierabend, Zugfahrt, Flohmarkt*) plus custom text import.
+  - Click any word in any text for instant lemma, gender, plural, English translation, audio pronunciation, and 1-click saving into the SRS deck.
+- **💬 Sprachpraxis (Vocabulary-Targeted Roleplay)**:
+  - Multi-turn real-world conversations that challenge you to weave **5 Zielwörter** into your German responses, with real-time inflection detection and V2 / subordinate clause word-order coaching.
+- **💾 Server + Local Persistence**:
+  - Syncs vocabulary state across devices via `/api/state` (`/app/data/wortkraft_state.json`) with `localStorage` fallback.