Native SwiftUI-Universal-App (iOS / iPadOS / macOS) für Zitare — Hybrid (WKWebView + Widget + ShareExt + native Submit) unter ev.mana.zitare.
Find a file
Till c89d48c6f6 ζ-2 native: SwiftData-Snapshot-Cache + DailyQuoteWidget
- SnapshotModels.swift: CachedQuote (slug-unique, themes/regions
  als CSV), SnapshotMeta (singleton mit lastSyncedAt + totalCount),
  SnapshotContainer.make() mit App-Group-Store-URL (Fallback auf
  App-Container für Dev ohne Apple-Dev-Portal-Setup)
- SnapshotSync (actor) mit injectable Loader für Tests: refresh /
  refreshIfStale / tryRefresh (fail-soft). Re-konsolidiert beim Pull
  (Update + Insert + Delete entzogene Slugs). 24h-Staleness-Default.
- DailyQuoteWidget: Hash-of-Day-Picker aus SwiftData, drei Sizes,
  Mitternacht-Refresh-Policy, Placeholder bei leerem Store. Widget-
  Target zieht SnapshotModels.swift mit (project.yml).
- ZitareNativeApp triggert SnapshotSync.tryRefresh() bei Launch +
  WidgetCenter.reloadAllTimelines() danach.
- AppConfig.snapshotURL = webBaseURL/index-min.json (Web-Endpoint
  noch nicht live, fail-soft).
- DeepLinkRouter Substring-Guard fix (`/t` statt `/t/` im
  Prefix-Array, sonst greift hasPrefix("/t//") nicht).
- 22 Tests grün (6 AppConfig + 11 DeepLinkRouter + 3 SnapshotSync +
  1 UI + 1 Widget-Compile-Smoke), swiftlint 0 violations in 22 Files

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-14 13:16:05 +02:00
ShareExtension ζ-0 Setup: Repo-Skelett, iOS-Build grün, Healthz live 2026-05-14 12:15:22 +02:00
Sources ζ-2 native: SwiftData-Snapshot-Cache + DailyQuoteWidget 2026-05-14 13:16:05 +02:00
Tests ζ-2 native: SwiftData-Snapshot-Cache + DailyQuoteWidget 2026-05-14 13:16:05 +02:00
Widgets/ZitareWidget ζ-2 native: SwiftData-Snapshot-Cache + DailyQuoteWidget 2026-05-14 13:16:05 +02:00
.gitignore ζ-0 Setup: Repo-Skelett, iOS-Build grün, Healthz live 2026-05-14 12:15:22 +02:00
.swiftformat ζ-0 Setup: Repo-Skelett, iOS-Build grün, Healthz live 2026-05-14 12:15:22 +02:00
.swiftlint.yml ζ-0 Setup: Repo-Skelett, iOS-Build grün, Healthz live 2026-05-14 12:15:22 +02:00
CLAUDE.md ζ-0 Setup: Repo-Skelett, iOS-Build grün, Healthz live 2026-05-14 12:15:22 +02:00
PLAN.md ζ-2 native: SwiftData-Snapshot-Cache + DailyQuoteWidget 2026-05-14 13:16:05 +02:00
project.yml ζ-2 native: SwiftData-Snapshot-Cache + DailyQuoteWidget 2026-05-14 13:16:05 +02:00
README.md ζ-0 Setup: Repo-Skelett, iOS-Build grün, Healthz live 2026-05-14 12:15:22 +02:00

zitare-native

Native SwiftUI-Universal-App (iOS / iPadOS / macOS) für Zitare, den öffentlichen Zitat-Korpus des Vereins mana e.V.

Hybrid-Architektur. Lese-Surfaces laufen im WKWebView gegen zitare.com. Native-Code ist nur dort, wo Native einen Distributions-Hebel hat: Home-Screen-Widget, ShareExtension, Spotlight-Index und Submit-View. Anders als cards-native, memoro-native und manaspur-native (alle „pure SwiftUI") — die Begründung steht im Playbook.

Status

Phase ζ-0 — Setup. Repo-Skelett, project.yml, leerer Build. Vollständiger 7-Phasen-Plan in ../mana/docs/playbooks/ZITARE_NATIVE_GREENFIELD.md. Phasen-Tracking in PLAN.md.

Lokal entwickeln

brew install xcodegen swiftformat swiftlint
xcodegen generate
open ZitareNative.xcodeproj

Voraussetzung: ../mana-swift-core/ und ../mana-swift-ui/ als Schwester-Verzeichnisse (Package-Dependencies via path:).

Bundle-IDs

Target Bundle
App ev.mana.zitare
Widget Extension ev.mana.zitare.widget
Share Extension ev.mana.zitare.share
App Group group.ev.mana.zitare

Cross-Refs