Orbit
Help · FAQ

Support

If something feels off — the circle won't draw your people, drift status looks wrong, notifications never arrive — start here. Most questions are covered below. If yours is not, write to us.

Contact
Email us

Getting started

What does Orbit actually do?

Orbit is a private iPhone instrument that maps your relationships into four nested layers — 5, 15, 50, 150 — and shows the gap between who you said is close (the declared layer) and who is actually close, based on how often you talk to them (the implied layer).

It is not a contacts app, not a CRM, not a social network. There is no feed, no reminders that you should "stay in touch", and no streaks.

How do I add a person?

From the Circle screen, tap the person-plus icon in the top right. Add a name (required), a declared layer (the inner 5, sympathy 15, friends 50, or active 150), and optionally a photo, a relationship tag (family, friend, partner, colleague), and a short note on why this person matters.

What's the "Lives with me" toggle?

People you share a home with are always in your inner 5 by definition — you don't need to log every conversation to prove it. Toggle Lives with me on Add/Edit Person, and Orbit will treat them as implied-5 permanently, and stop asking about drift for them.

Do I have to add all 150 people?

No. Add the people you actually want to think about. Most users start with five to ten and grow from there. The point isn't completeness — it's clarity about the few that matter.

Layers & alignment

What do the four layers mean?

From the work of Robin Dunbar and colleagues:

What is "alignment"?

Alignment is the gap between the layer you declared for someone and the layer their actual contact frequency places them in. Orbit reports one of four states:

The dot colour on the Circle screen encodes this state.

Can I change the frequency thresholds?

Yes. The defaults come from peer-reviewed research (Sutcliffe, Dunbar et al., 2012). If your relationships move at a different cadence — say you have weekly catch-ups that you consider sympathy-15 rather than inner-5 — open Settings → Frequency thresholds and adjust. Reset to research defaults is one tap away.

Why did Orbit "promote" mom to my inner 5 on her own?

It didn't — Orbit never changes a declared layer on its own. What you saw is a suggestion banner: if your contact behaviour is consistently more frequent than the declared layer requires, Orbit asks whether you'd like to move the person closer. You decide. Decline and the banner goes away.

Logging contact

What counts as a contact?

Any meaningful interaction with that person. A text exchange, a call, a meal, a walk. The point is not to count notifications — it's to count moments. We do not distinguish a two-minute text from an hour-long conversation by default, though you can optionally rate quality 1–5 when you log.

How do I log a group conversation?

Tap the floating + button, then tap multiple people in the list before pressing Log. A single contact is recorded for each selected person at the same timestamp. Ideal for "dinner with mum and sister."

What does "Direction of energy" mean?

An optional field when you log a contact: who reached out — I did, they did, or Mutual. Leave it blank if you don't want to think about it. Once you have ten contacts with this field filled in for one person, Orbit can surface the ratio on their detail screen.

I forgot to log yesterday's conversation. Can I backdate?

Editing the date isn't in v1.0 — Orbit aims to be a behavioural record, not a meticulous diary. Log it today; the rolling 30 / 90 / 365 day windows will absorb the small delay without distorting your data.

Reality Check & Stats

How often does the Reality Check update?

You can tap the refresh button on the Reality Check screen at any time. The weekly notification (if you have it enabled) lands on Sunday at 18:00 local. Sections that have nothing to report — for example, no drift this week — are hidden so the report doesn't feel padded.

What does Phantom Inner 5 mean?

The headline number on the Reality Check screen: of the people you declared as inner-5, how many are actually inner-5 by behaviour. "2 / 5" means three of your declared inner circle are behaving like a more distant layer.

What is a "Ghost"?

A person you declared in your inner 5 or 15 with zero contact in the last 365 days. Orbit flags them as ghosts not to shame you, but to ask: do they really belong here? You decide.

The Stats screen says I have no migration data. Why?

The migration map compares each person's implied layer at the start of the chosen period to their implied layer today. Orbit needs weekly snapshots, written automatically as you use the app. If you've only had Orbit for a few weeks, give it time to accumulate.

Notifications

What notifications does Orbit send?

Two kinds, both opt-in:

No streaks, no "keep it up", no guilt-trips. Ever.

I enabled notifications but nothing arrives.

Three things to check, in order:

Privacy & data

Does Orbit see who's in my circle?

No. The people you add, your contact log, your photos and notes never leave your iPhone. We have no servers that store this data. Full details in the privacy policy.

Why does Orbit ask about tracking when I open it?

iOS shows a system prompt the first time an app uses tracking SDKs. Orbit uses AppsFlyer to measure which marketing channel brought you in. If you tap Ask App Not to Track, AppsFlyer falls back to Apple's privacy-preserving SKAdNetwork and Orbit works identically. The prompt is a one-time decision — you can change it later in iOS Settings → Privacy & Security → Tracking → Orbit.

How do I export or wipe my data?

Both live in Settings → Data:

Troubleshooting

The Circle screen shows the wrong colour for a person.

The dot colour reflects alignment, which depends on (a) the person's declared layer, (b) their contact history, and (c) the current frequency thresholds. Open the person detail to see all three. If you recently logged a contact, pull-to-refresh or re-open the screen — implied layer updates immediately but the rendered colour can lag by a frame.

I can't unlock the app with Face ID.

App Lock uses iOS's standard biometric flow. If Face ID fails, the system passcode prompt should appear automatically. If it does not, force-quit Orbit (swipe up from the home indicator and flick the card up), then reopen. Confirm iOS Settings → Face ID & Passcode → Orbit is enabled, and that Settings → Privacy → App Lock inside Orbit is on.

The app feels slow after I added a lot of people.

Orbit is built for hundreds, not thousands. If you're past ~500 active people and seeing lag on the Circle screen, archive anyone you no longer want to track (person detail → Archive). Archived people are excluded from the Circle, Stats, and Reality Check, but their data is preserved.

iOS version requirements?

Orbit requires iOS 15.0 or later. iPhone only in v1.0 — iPad and Apple Watch are on the roadmap.

Quick fixes

Tip · 01

Force-quit and reopen

Fixes most stuck states. Implied layer recalculates on every cold launch.

Tip · 02

Pull to refresh Reality Check

The Refresh button in the top right regenerates the report against your latest data.

Tip · 03

Reset thresholds

If alignment colours look strange, restore research defaults in Settings → Frequency thresholds.

Tip · 04

Archive, don't delete

Archive keeps history intact in case the relationship reignites. Delete is permanent.

Feature requests & bug reports

Same address: boytik@actvox.dev. Please include:

Current roadmap, in priority order: