Support

The most common questions and how to fix them. Email reaches a real human.

Setup

Eclipsed says "No sleep data yet" but I've worn my watch

Three things to check, in order:

1. Open Settings → Data Source. If HealthKit shows "Not connected," tap Connect.
2. If it's already connected, open the iOS Settings app → Health → Data Access & Devices → Eclipsed and confirm Sleep Analysis is enabled.
3. Open the Health app and confirm sleep records actually exist there. If Health is empty, your watch may not be syncing. That's an Apple Watch issue, not an Eclipsed issue.

I changed my target and the numbers look weird

Eclipsed recomputes the entire 30-day window when you change your target or window size. Pull up Tonight or open Settings and tap Refresh if anything looks stuck.

Apple Watch

The watch app is empty but the iPhone app works

The watch asks for Health access separately from the iPhone. Granting access on the phone does not grant it on the watch. Open Eclipsed on your watch and accept the Health prompt there; if a request appears on your iPhone instead, approve it from the phone. This is how Apple designed Health permissions, and it only needs doing once.

The watch shows a different number than the phone

Your iPhone computes the full history and pushes its numbers to the watch, so the phone is always the source of truth. If the watch looks behind, open Eclipsed on the iPhone once; the fresh numbers reach the watch on the next connection between the two devices.

The complication isn't updating

Complications refresh on the system's schedule, plus whenever you open the watch app. Sleep debt only moves once per night, so a complication that matches yesterday evening's number is usually just accurate. If it seems genuinely stuck, open the watch app once to force a refresh.

Sleep Intelligence

I don't see the reflection feature

Sleep Intelligence requires a device with Apple Intelligence enabled. On devices without it, the Reflect entry doesn't appear and everything else in Eclipsed works exactly the same.

How often does it write?

Every two weeks, covering the nights since the last reflection. It is written entirely on your device, and no one else ever sees it.

iCloud sync

What syncs, and where?

Your computed history and reflections sync between your devices through your own private iCloud database. Nothing passes through any server of ours, and no one but your signed-in devices can read it. See the privacy policy for the full picture.

How do I turn sync off?

iOS Settings → your Apple Account → iCloud → see all apps using iCloud → toggle off Eclipsed. Your local data stays on each device; it just stops moving between them.

Reading the gradient

The five stages

• Slate: under 2 hours of debt over your window. You're rested.
• Mist: 2 to 5 hours. Mild deficit.
• Plum: 5 to 10 hours. Building up.
• Rust: 10 to 20 hours. Significant.
• Crimson: 20+ hours. You've been carrying this for a while.

These thresholds assume the default 14-day window. If you've changed it, the meaning shifts proportionally.

What's a "gap day"?

A night where Eclipsed couldn't find any sleep data, usually because you didn't wear your watch. Gap nights show as dimmed chips in the strip and "No data" in History. They contribute zero to your debt total, which is the most honest thing we can do without inventing data.

Widget

The widget shows old data

Widgets refresh when you open the app, plus once an hour as a fallback. If the widget feels stale, opening Eclipsed once will push fresh numbers.

The widget says "Connect HealthKit in the app"

Open Eclipsed and complete the connect flow in Settings. Once data starts flowing, the widget will update on its next refresh.

Privacy

Where does my sleep data go?

It stays on your devices, and if you use iCloud sync, it moves between them through your own iCloud. Nowhere else. Read our privacy policy for the full version.

How do I revoke HealthKit access?

iOS Settings → Health → Data Access & Devices → Eclipsed → toggle off Sleep Analysis. Eclipsed will stop reading new data immediately. The watch has its own grant; revoke it the same way on the watch if you want both off.