Signing in — FocusDragon Docs

Where to sign in

Open FocusDragon.
Click Settings in the sidebar, then the Account tab.
Click "Sign In" and pick Google or Apple in the popover.

You can also click the auth pill at the bottom of the main sidebar — it says "Sign in" when you're signed out and switches to your name once you're authenticated. Both routes hit the same OAuth flow.

What the OAuth handshake looks like

Picking Google or Apple opens your default browser at the provider's consent screen. Approve, and the provider redirects through our authentication partner to a short-lived focusdragon:// custom URL scheme callback that the Mac app is registered to handle. The browser tab will flash a "You can close this tab now" page, macOS hands the URL back to FocusDragon, and the app exchanges the token automatically — usually under a second. No password is ever typed into the FocusDragon app itself.

If the browser tab hangs on the callback (sometimes happens with aggressive browser extensions or strict firewalls), close the tab and try again. The flow is idempotent — nothing is half-created on a failed callback.

Why sign-in is required to start a block

Browsing the app, configuring blocks, picking lock types, even editing AI task contexts — all of that works fully signed out. The signed-in check fires the moment you press Start. The reason is that an account is what attaches your Pro unlock, AI Focus subscription, BYOK add-on, and usage quota to a stable identity. Without one, there's no way to verify what tier of features you're entitled to.

If the sidebar pill still says "Sign in" when you press Start, the button silently no-ops and a tooltip points you back at the Account tab.

Signing out and switching accounts

Settings → Account → Sign Out clears the current session. You can then sign back in as a different user — useful on a shared Mac, or when you want to test a free-tier session while owning Pro. Your blocks, lock configurations, focus history, and statistics all stay on the Mac (they're stored locally, not server-side), so swapping accounts does not wipe any of your local data. Entitlements switch over to whoever's currently signed in.

Because local blocks are shared across whoever is signed in on this Mac, a second user on the same machine sees your blocks too. If you want true per-user separation, use separate macOS user accounts — that's the boundary FocusDragon respects.

iOS companion

Signing into the iOS companion uses the same Google/Apple OAuth and the same account. Entitlements flow across — buy Pro once on the Mac, sign in on iOS, and Pro is live there too.