Abkus Hub — Manual
Step-by-step per screen, with a topical index (7 topics). Use “Download PDF” to save this page as a PDF (print → Save as PDF). Shipped with your subscription.
Your account
Everyday Hub: who is logged in, what they subscribe to, and personal settings.
Dashboard
What it does: Home after login. It shows live counts from Hub’s database: registered users, active subscriptions, and LLM spend Hub recorded for the last 30 days. It is a snapshot, not a control panel.
Open this when: You want a quick “is anyone using Hub / are we spending on models?” view.
Not this: It does not configure SSO, plans, or the LLM fleet. Superadmin work starts at Superadmin, not here.
Steps & key controls
- Live count cards (users, subscriptions, AI spend) — A snapshot of Hub usage at a glance — read-only totals from the database, so you see activity without touching any configuration.
- Recent AI spend — Shows what the LLM fleet cost in the last 30 days, surfacing spend trends before they reach the cost monitor.
Accounts
What it does: Lists people who have a Hub identity (the same login used on every Abkus app). You can see who exists and high-level subscription status. Password reset and 2FA live under the user’s own security settings, not this table.
Open this when: You need to find a person, confirm they have an account, or scan who is subscribed.
Not this: This is not SSO client registration (that is SSO Clients) and not “who pays for which plan” in full (that is Subscriptions).
Steps & key controls
- User rows (email, subscription status) — The directory of Hub identities — find a person and see high-level subscription state; full billing detail lives on Subscriptions.
Billing (your subscriptions)
What it does: The customer checkout for Abkus apps (SBM, Travel, and the rest). Plans and prices come from Hub’s catalog. Checkout talks to the active Merchant of Record. Query params `app`, `plan`, and `cycle` highlight a specific plan when a satellite sent the user here.
Open this when: You (or a customer) need to start, change, or understand an Abkus subscription.
Not this: This is not where you paste Paddle/Stripe API keys or edit plan prices. That is Billing (MoR) and Plans & Products under Superadmin.
Steps & key controls
- Tabs: Subscriptions | Receipt method — Separates the two billing levels that must never be confused: Level 1 (Abkus charging you, checkout below) and Level 2 (you charging your own customers, merchant keys).
- Highlighted checkout card + Subscribe buttons — A satellite app can deep-link here with app/plan/cycle to pre-highlight the exact plan the customer chose; Subscribe opens the active Merchant of Record checkout.
- Receipt method panel (Level 2) — Lists your own merchant credentials, lets you paste provider keys per gateway, test the connection, and shows each credential’s webhook URL to paste into the provider dashboard.
- Test subscribe (provisional password) — Fail-safe when no payment processor is configured: subscribing with the canonical password exercises the billing flow without charging anyone.
- Manage Billing ↗ — Opens the processor’s customer portal for subscription changes on Abkus’s side (upgrade, card, invoices).
Your account
What it does: The Hub account page: your photo, name and email, the identity every Abkus app sees. When an app opens it, it renders in that app’s context with a “Back to app” link. Full preferences live in Settings; subscriptions in Billing.
Open this when: You want to change your photo or check the identity every app shows.
Not this: Theme/language and API keys are Settings. Subscriptions and receipts are Billing. Password changes are Security.
Steps & key controls
- Profile photo (upload / remove) — One photo for every Abkus app — changing it here updates the shared identity, synced back to the Hub IdP.
- Subscriptions / Preferences cards — Jump to Billing (plans and receipts) or Settings (theme, language) without hunting the menu.
Settings
What it does: Personal Hub preferences for the signed-in user: appearance, language, and account-linked options. It does not change another app’s branding or feature flags.
Open this when: You want Dark/Light, language, or your own Hub account options.
Not this: Runtime product toggles for all users are Feature Flags. Tenant logos are not configured here.
Steps & key controls
- Appearance (Light / Dark) — Personal visual theme for the signed-in user — does not change app branding or tenant logos.
- Language / locale — Sets the interface language for this account; the Hub chrome and app surfaces follow the chosen locale.
Security
What it does: Account security for the signed-in user: change the current password (confirming the old one) or email a password-reset link. Passwords are hashed with argon2; this screen never shows or stores the old one.
Open this when: You suspect your password leaked, rotate passwords periodically, or lost it on another device.
Not this: This is your Hub identity only — app-level logins do not exist (Hub SSO is the one login). Two-factor authentication is not offered here.
Steps & key controls
- Change Password (current + new + confirm) — Rotates your Hub password in place; confirming the current password proves it is really you before the new one is accepted.
- Forgot Password → Send reset link — Emails a one-time reset link for when you are locked out on another device; the link flow is the same one satellites reuse for lost passwords.
Help Center
What it does: The catalog this whole system is built on. Every screen of Hub has a topic with “what this does”, “open this when…”, “this is not…”, and links to the screens people confuse it with. The same copy appears on the screen itself via the “What this screen is for” explainer.
Open this when: Any screen or command looks unfamiliar — search the index instead of guessing.
Not this: It documents Hub screens, not satellite-app screens (each app has its own help). It is not a tutorial player.
Steps & key controls
- Group index (by concern) — Groups every cataloged screen so you can scan by area instead of knowing the exact screen name.
- Topic cards — Each card carries the screen’s one-liner and opens the full topic (what it does / open this when / not this / related).
Generated from the same source as the in-app Help Center (/help).