Help Screens Sign-in & identity
Verify your email AUTH-04
Tell the user to check email; complete verification from the emailed link.
| Who can use it | Signed in (unverified) or token holder |
|---|---|
| Where it is | /verify-email · link: https://hub.substratalapps.com/verify-email or substratal://verify-email |
| Available on | Web (PWA), iOS / iPadOS, Android, Windows, Linux (GNOME), macOS |
| Phase | MVP |
What you can do here
- Deep link opened — 204 → success state, refresh User. 400 → "This link has expired." + Resend.
- Resend email — Always 202 → toast "If that address needs verifying, we sent a new link."
Related guides
- Signing in and keeping your account secure — Sign in, two-factor authentication, sessions and signing out everywhere.
On your platform
| App | Status | How it's built |
|---|---|---|
| Web (PWA) | — | Standalone route outside the app shell, centered card ≥ 768 px, full-bleed on phone |
| iOS / iPadOS | — | fullScreenCover |
| Android | Planned | Route outside NavigationSuiteScaffold |
| Windows | — | Full-window page before the shell (no NavigationView) |
| Linux (GNOME) | — | Separate AdwWindow with AdwClamp |
| macOS | — | Separate Window scene (720×560, no sidebar) |
Status is reported by each app's repository; — means that app doesn't report it yet.
For developers: API calls
| Method | Path | What it does |
|---|---|---|
| POST | /auth/email/verify | Confirm an email address from an emailed token |
| POST | /auth/email/verify/resend | Re-send a verification email (always 202) |
Every call sends Substratal-Version: 1. Paths are at the host root, with no /v1.