Skip to main content

Getting Started

Logging in​

Nexus authenticates through Keycloak. When you're not signed in, the header shows a Login button; clicking it takes you through your organization's Keycloak login page and back into Nexus once you authenticate.

There is no separate "create my account" step. The first time you sign in, Nexus resolves your Keycloak identity to an Owner record behind the scenes — this is what everything you create (wallets, templates, credential types, API clients) is scoped to. If that resolution ever fails, you'll see an anonymous/unauthenticated placeholder instead of the app's content; signing in again resolves it.

Logging out​

Open the user menu (your avatar, top right) and choose Logout. This ends your Keycloak session as well as your Nexus session.

Layout overview​

The top navigation bar has three entries:

  • Dashboard — your home screen: the list of your identities (wallets) plus quick-access panels for credentials and verification results.
  • Building Blocks — where you design reusable Identity Templates and Credential Types before creating actual wallets.
  • About — an in-app reference page describing the platform and its capabilities.

Two more surfaces are reached from the header itself rather than the main nav:

  • A bell icon opens your unread Messages — the inbox for anything a counterparty wallet sends you (connection invitations, credential offers, verification requests) that needs your action. See Accepting Credentials.
  • Your avatar opens a dropdown with Settings (account-wide configuration — see Settings) and Logout.

Everywhere you go, a floating Nexus Assistant button sits in the bottom-right corner of the screen — it's a chat panel that can answer questions and perform actions for you. See The Nexus AI Assistant.

Your first visit — the empty state​

If you haven't created any identities yet, the Dashboard shows:

  • An info banner: "No identities yet. Create one to get started."
  • A highlighted "Get started with Nexus" card suggesting you ask the Nexus AI assistant about your requirements — it can help you choose the right trust framework, credential types, and wallet configuration.

From here you have two paths to your first working wallet:

  1. Guided/manual path — go to Identity Templates, build (or import) a template, then create a wallet from it. This is the path the rest of this guide follows in order.
  2. AI-assisted path — open the Nexus Assistant and describe what you're trying to do (e.g. "I need a wallet that issues employee ID badges as SD-JWT VC credentials"); it can create the credential type, the template, and the wallet on your behalf, asking for your confirmation before each write. See The Nexus AI Assistant.

Continue to Identity Templates.