Signed-off-by: Matt Bruce <mbrucedogs@gmail.com>

Andromida/Andromida.entitlements

@@ -10,6 +10,8 @@
 	<array>
 		<string>CloudKit</string>
 	</array>
+	<key>com.apple.developer.ubiquity-kvstore-identifier</key>
+	<string>$(DEVELOPMENT_TEAM).$(APP_BUNDLE_IDENTIFIER)</string>
 	<key>com.apple.security.application-groups</key>
 	<array>
 		<string>$(APP_GROUP_IDENTIFIER)</string>

PRD.md

@@ -265,6 +265,7 @@ Implementation note: Onboarding flows and root-level shell transitions should av
 | TR-DATA-03 | Use UserDefaults for user-created categories and preferences |
 | TR-DATA-04 | Use App Group shared container for widget data access |
 | TR-DATA-05 | Run a startup integrity migration to normalize arc date ranges, in-progress arc state, and persisted sort indexes |
+| TR-DATA-06 | Enable iCloud runtime compatibility by shipping `com.apple.developer.ubiquity-kvstore-identifier` and `remote-notification` background mode when CloudKit/KVS sync is enabled |
 
 ### 5.4 Third-Party Dependencies
 

README.md

@@ -194,6 +194,7 @@ String catalogs are used for English (en), Spanish (es-MX), and French (fr-CA):
 - App is configured with a dark theme; the root view enforces `.preferredColorScheme(.dark)` to ensure semantic text legibility.
 - Setup wizard and root shell animations respect the iOS **Reduce Motion** accessibility setting.
 - The launch storyboard matches the branding primary color to avoid a white flash.
+- iCloud sync configuration includes `com.apple.developer.ubiquity-kvstore-identifier`; enable `remote-notification` background mode via Xcode Capabilities when CloudKit push handling is needed.
 - App icon generation is available in DEBUG builds from Settings.
 - Fresh installs start with no rituals; users create their own from scratch or presets.
 - A startup data-integrity migration normalizes arc date ranges, in-progress arc state, and sort indexes.