← Back to Eclipsed

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.

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?

Nowhere. Read our privacy policy for the full version, but the short version is: it stays on your phone.

How do I revoke HealthKit access?

iOS Settings → Health → Data Access & Devices → Eclipsed → toggle off Sleep Analysis. Eclipsed will stop reading new data immediately.