Native SwiftUI-Universal-App für Cardecky (mana e.V.). Web-Parität zu cardecky.mana.how. SOT: mana/docs/playbooks/CARDS_NATIVE_GREENFIELD.md
Find a file
Till JS a1770fbc6a v0.7.0 — Phase β-6 Native-Polish
Drei Sub-Pakete: Keyboard-Shortcuts, Daily-Reminder-Notifications,
WidgetKit-Extension mit App-Group-Daten-Sharing. Siri-Shortcuts
und Share-Extension auf β-7 verschoben — niedrige Priorität, die
drei großen Brocken decken 90% des Native-Polish ab.

Keyboard-Shortcuts:
- Hidden Buttons in StudySessionView mit .keyboardShortcut
- Space = flip, 1/2/3/4 = again/hard/good/easy
- iPad-Magic-Keyboard + macOS-tauglich

Daily-Reminders:
- NotificationManager @Observable mit UNUserNotificationCenter
- Authorization-State + Permission-Request-Flow
- UNCalendarNotificationTrigger täglich zur konfigurierten Zeit
- SettingsView in AccountView mit Toggle + DatePicker
- UserDefaults-Persistierung von Hour/Minute/Enabled

WidgetKit-Extension:
- WidgetSnapshot Codable mit topDecks (Top-3 by dueCount) + totalDueCount
- WidgetSnapshotStore schreibt in group.ev.mana.cards-Container
- DeckListStore.refresh schreibt Snapshot + WidgetCenter.reloadAllTimelines
- CardsWidgetExtension-Target im project.yml (app-extension)
- CardsWidgetBundle + CardsDueWidget mit 5 Familien (small/medium/
  accessoryCircular/accessoryInline/accessoryRectangular)
- DueProvider TimelineProvider mit 30-min-Refresh
- DueWidgetView Family-Switch
- WidgetSnapshot.swift shared in beiden Targets via XcodeGen sources
- App-Group im Haupt- und Widget-Entitlement

35 Tests grün (keine neuen Tests in β-6 — WidgetKit + Notifications
sind System-API-Integrationen, Tests wären überwiegend Mocks).
Build inkl. Widget-Extension grün.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-13 01:00:04 +02:00
Sources v0.7.0 — Phase β-6 Native-Polish 2026-05-13 01:00:04 +02:00
Tests v0.6.0 — Phase β-5 Marketplace 2026-05-13 00:51:12 +02:00
Widgets/CardsWidget v0.7.0 — Phase β-6 Native-Polish 2026-05-13 01:00:04 +02:00
.gitignore v0.1.0 — Phase β-0 Setup 2026-05-12 19:29:45 +02:00
.swiftformat v0.1.0 — Phase β-0 Setup 2026-05-12 19:29:45 +02:00
.swiftlint.yml v0.1.0 — Phase β-0 Setup 2026-05-12 19:29:45 +02:00
CLAUDE.md v0.1.0 — Phase β-0 Setup 2026-05-12 19:29:45 +02:00
PLAN.md v0.7.0 — Phase β-6 Native-Polish 2026-05-13 01:00:04 +02:00
project.yml v0.7.0 — Phase β-6 Native-Polish 2026-05-13 01:00:04 +02:00
README.md v0.1.0 — Phase β-0 Setup 2026-05-12 19:29:45 +02:00

cards-native

Native SwiftUI-Universal-App (iOS / iPadOS / macOS) für Cardecky — die Spaced-Repetition-Karten-App des Vereins mana e.V.

Web-App-Parität. Die existierende Web-App auf cardecky.mana.how ist Funktions- und Verhaltens-Referenz. Native bringt kein neues Produkt, sondern die App in einer Form, die iOS-Hardware besser nutzt.

Status

Phase β-0 — Setup. Leerer Build, Login funktioniert, Cardecky-API- Reachability-Check. Vollständiger Phasen-Plan in ../mana/docs/playbooks/CARDS_NATIVE_GREENFIELD.md.

                       HTTPS/JWT      ┌──────────────────┐
   cards-api          ◄─────────────  │ cards-native     │  SwiftUI
   cardecky-api.mana.how              │ ev.mana.cards    │  WidgetKit (β-6)
                                      └──────────────────┘
                                               │
              ┌─────────────────────────────────────────┐
              ▼                                         ▼
   ManaCore (Auth, Transport)         ManaTokens (Designwerte)
   git.mana.how/till/mana-swift-core v1.0.0+

Lokal entwickeln

xcodegen generate
open CardsNative.xcodeproj      # iPhone-17-Simulator

Konventionen, Invarianten, Phasen-Disziplin: CLAUDE.md.