Zum Inhalt springen
Frank David Lee EN

Alle Projekte

In Arbeit

heyAppa

Spielerische Sprachlern-App – zuerst für Koreanisch.

Zeitraum
seit Juli 2026
Rolle
Konzept, Entwicklung und Betrieb (Solo)
Status
In Arbeit
Technik
  • Next.js
  • React
  • TypeScript
  • Tailwind CSS
  • Prisma
  • PostgreSQL
  • pgvector
  • Anthropic SDK
  • Zod
  • Vitest
  • AWS
  • Terraform
Start: Tokki, Tages-Quest, Serie, XP und Level – Lernen als kleines tägliches Spiel.

Produkttour im Video

Ohne Ton, mit Untertiteln. Alle Daten im Video sind erfunden.

Problem

Eine Sprache mit eigener Schrift zu lernen braucht Ausdauer – und Übung, die Spaß macht. Ich lerne selbst Koreanisch. Eine Lern-App sollte dabei niemanden ausschließen: auch nicht, wer mit Tastatur oder Screenreader lernt.

Lösung

heyAppa ist eine spielerische Sprachlern-App, zunächst für Koreanisch. Durch die App begleitet heute Tokki, ein Mondhase – wahlweise ein kleines Einhorn. Für die Neugestaltung steht Appa, ein lila Drache, schon fest: mit einer eigenen Charakter-Bibel als verbindlicher Quelle für seine Gestalt.

  • Übersetzungen und Geschichten mit einem LLM über das Anthropic SDK.
  • Zehn Quiz-Arten: vom Hör-Quiz über Satz-Puzzle, Diktat und Laut-Regeln bis zum Live-Duell gegen Freunde – auf Wunsch im Challenge-Modus mit drei Herzen.
  • Gemeinsam lernen: Gruppen, Wochenziel zu zweit, Satz des Tages und ein Markt für Decks und Geschichten.
  • Wiederholung mit Karten zum Umdrehen; eigene Reihenfolgen per Drag-and-drop – mit Maus, Touch oder Tastatur.
  • Oberfläche auf Deutsch, Englisch und Koreanisch.

Barrierefreiheit

Bevor die Oberfläche neu gestaltet wird, kam die Barrierefreiheit in drei Runden. Sie gilt seitdem als Grundlage, die nicht zurückfallen darf.

  • Kontrast-Tokens, Fokusfalle in Dialogen und Tastaturbedienung für die Wiederholung; globale Kurzbefehle lösen in Eingabefeldern nicht mehr aus.
  • Sichtbarer Fokus und Fokusführung in Kontextmenüs; keine verschachtelten interaktiven Elemente, nach dem Umdrehen einer Karte kehrt der Fokus zurück.
  • Sortieren per Tastatur mit Screenreader-Ansagen; Hinweise und Ansagen auf Deutsch, Englisch und Koreanisch, abgesichert mit Tests.

Architektur und Entscheidungen

  • Next.js 16 (App Router) mit React 19, TypeScript und Tailwind 4; Prisma 6 mit PostgreSQL und pgvector; Zod an den Grenzen, Tests mit Vitest.
  • Betrieb auf AWS, Infrastruktur mit Terraform; beim Deployment laufen Migrationsprüfung, Build und Neustart des Dienstes nacheinander.
  • Agenten mit klaren Rollen: Claude Code setzt je Pull Request genau eine Aufgabe um, Codex prüft die Änderung nur lesend, Befunde gehen in denselben PR zurück. Sichtbare Änderungen gehen erst nach meiner Sichtprüfung weiter, gemergt wird nur von Hand.
  • Der Agent arbeitet als reiner Editor in einem frischen Arbeitsverzeichnis; Branch, Commit und PR übernimmt ein Orchestrator, der nur freigegebene Pfade zulässt.
  • Neugestaltung mit eingefrorener Grundlage: Designbrief, Design-System als Umsetzungsvertrag und Briefings je Ansicht – die Logik bleibt dabei unangetastet.

Stand

heyAppa läuft in einem geschlossenen Familientest und wird weiterentwickelt. Die Runden zur Barrierefreiheit sind abgeschlossen, die Neugestaltung ist geplant und dokumentiert.

Architektur

So laufen meine Apps

Ein kleiner Server, Cloudflare davor, GitHub für Tests und Auslieferung: die Architektur hinter den Projekten, mit Zeichnung.

Bildschirmfotos

Zehn Quiz-Arten – im Bild die ersten sechs: Klassisch, Hör-Quiz, Satz-Puzzle, Nachsprechen, Blitz-Paare und Diktat. Dazu kommen Laut-Regeln, Zahlen & Zählwörter, Blitz-Duell und Schreiben üben.
Stories: kurze Dialoge aus dem Familienalltag zum Lesen und Hören – eigene schreiben oder mit KI erzeugen.
Wörterliste: Decks für Tochter, Schwiegereltern und Essen, Lernsprache verdeckt, Aussprache per Tipp.