Everything about how the app communicates with the sync server and what you can configure.
How sync works
Couples Goals uses a local-first design. Every action (logging, creating a challenge, earning XP) is saved on your device immediately, with no network dependency and no waiting on a connection. Sync runs quietly in the background and brings both partners' devices to the same state.
Every action is saved locally right away and marked as needing to sync.
In the background, the app sends anything pending up to the server.
Once the server confirms, those items are marked as fully synced.
The app then fetches everything that's changed since your last sync, including your partner's shared entries, XP balances, and profile changes.
If the same item was changed on both devices before syncing, whichever change happened most recently wins.
XP is merged, not overwritten: your phone sends only the XP it earned or spent since its last sync, so XP the server added or took in between (a gift, a Taxman, a bought bundle) is never lost.
Admin changes propagate automatically
If a server administrator changes your display name, XP balance, or links/unlinks your partner, those changes reach your device on the next sync. You don't need to take any action. Changes your partner makes that involve you arrive within seconds (see "Partner push" in the table below).
Sync triggers
Trigger
Delay
Notes
App launch
5 seconds
Gives the UI time to render before network work begins
Network reconnect
5 seconds
Fires when WiFi/mobile data becomes available
After logging progress
Immediate
Ensures partner sees new entries quickly
After social interaction
Immediate
Reactions and comments pushed right away
After partner link
Immediate
Full pull runs inline on both devices, with no wait for the background cycle
After freeze auto-apply
Immediate
The applied freeze is synced right away so your partner sees the updated calendar
Partner push
Seconds
When your partner does something that involves you (nudge, reaction, voucher, sabotage, gift, co-op progress, link/unlink), the server sends your phone a content-free "sync now" message through Google's push service. Devices without Google Play services fall back to the periodic sync
XP purchase
Immediate
After buying an XP bundle the app asks the server to credit it; the server confirms the purchase with the store and the new balance comes back right away
Periodic background
Every 30 min
Runs automatically whenever you have a network connection
Manual Sync Now
Immediate
Settings → Sync Now button
Settings reference
Sync
Custom server URL: Leave blank to use the built-in default server. Enter your own address only if self-hosting (see the Self-Host page for setup details).
Sync Enabled: Toggle background sync on or off. Disabling this makes the app fully offline.
Sync Status: Shows "OK" (green) after a successful pull, "Never" (orange) if no sync has run, or "Disabled" if sync is off.
Last Sync: Relative timestamp of the last successful pull (e.g. "2 minutes ago").
Sync Now: Manually trigger an immediate push + pull cycle.
Notifications
Daily Reminder Time: Tap to pick the time your reminder fires each day. Reminders only fire for your own challenges. This is the account-wide default; Couple Pro accounts can override it per individual challenge from that challenge's own detail screen.
Quiet Hours: When enabled, no notifications are sent during the defined window (default 10 PM – 7 AM).
Sound Effects: Toggle celebration sounds that play on XP milestones and challenge completion.
Theme
Rose & Pink (Feminine): Warm rose and deep pink color palette. Free.
Steel Blue & Teal (Masculine): Deep blue and teal color palette. Free.
Rose Gold, Midnight Amethyst, Retro Neon: Three additional tint-accent themes. Require Couple Pro; selecting one on a free-tier account shows an upgrade prompt instead.
Dark Mode: Overrides the system theme. All UI elements including the challenge calendar are fully dark-mode aware, across all five themes.
Account
Partner: Tap to open the partner linking screen. Shows current linked partner name, or allows generating/entering a code.
View Archived Goals: Browse all archived challenges; permanently delete them here.
Documentation & Help: Opens this documentation site in your browser.
Send Feedback: Opens the feedback form at /feedback in your browser. No account required.
Diagnostic Logs: View an in-app log of all sync events, auth actions, and errors.
Log Out: Signs you out of the app on this device without deleting anything. Your account, challenges, and progress are untouched and safely stored on the server (or your local device, if sync is off). Log back in any time, on this device or another, to pick up right where you left off.
Delete Account: The one truly destructive setting, kept in its own red-bordered “Danger Zone” card. Two-step confirmation (are-you-sure, then an irreversibility warning) followed by re-entering your password (or, for an account made with Google Sign-In, typing a confirmation phrase), then your account and all of your own data (challenges, progress, XP, vault content) is permanently deleted and you're signed out. Your partner's account and data are never touched.
Debug Tools (development builds only)
Visible only in debug/development builds, gated behind a separate Debug Tools screen off Settings, and never present in the version distributed on Google Play. Consolidates every on-demand test trigger in one place: firing a Sparky AI Coach message for any trigger type, showing the Streak Celebration Dialog at a chosen streak value, inserting or generating a Habit Insight, simulating any age-signal state (Adult, Minor 13–15, Minor 16–17, Supervised, Blocked, Unknown, etc.) without being in a covered jurisdiction, and resetting the once-a-day gates that would otherwise block repeat-testing any of the above on the same day. Changes take effect immediately.
Staying signed in
Your login stays active for 30 days. When it expires, the next sync attempt will prompt you to sign in again. The app will:
Post a local notification: "Sign in required".
Show a sign-in prompt when the notification is tapped.
Clear the expired session automatically.
Simply log in again and sync will resume on the next trigger.
Admin force-logout
A server administrator may invalidate your session at any time using the admin panel. If this happens you will receive a "Session invalidated. Please sign in again" message on the next sync attempt.
Diagnostic logs
The app maintains a rolling log of internal events accessible at Settings → View Logs. Use the filter chips (DEBUG / INFO / WARN / ERROR) to narrow down issues. Relevant entries include sync push/pull summaries, partner link events, age signal results, streak freeze auto-applies, and any errors.
Tap the Share icon to export all logs as a plain-text file you can send to support. Logs are stored locally and are never transmitted automatically.