Native SwiftUI-Universal-App (iOS / iPadOS / macOS) für Zitare — Hybrid (WKWebView + Widget + ShareExt + native Submit) unter ev.mana.zitare.
- 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>
|
||
|---|---|---|
| ShareExtension | ||
| Sources | ||
| Tests | ||
| Widgets/ZitareWidget | ||
| .gitignore | ||
| .swiftformat | ||
| .swiftlint.yml | ||
| CLAUDE.md | ||
| PLAN.md | ||
| project.yml | ||
| README.md | ||
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
WKWebViewgegenzitare.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
- Playbook:
../mana/docs/playbooks/ZITARE_NATIVE_GREENFIELD.md - Web-App:
../zitare/CLAUDE.md - Plattform-SOT:
../mana/docs/MANA_SWIFT.md - Shared Code:
../mana-swift-core/,../mana-swift-ui/