Set Up Sample Application

This page walks you through the quick path: download the sample, import a pre-built bundle into ThunderID, and run the app. Everything the walkthroughs need is created in one step.

Prefer to build the setup manually?

Skip the bundle import and follow Configure It Yourself instead. It creates the same resources step by step through the console and API.

Set Up Your Environment

1

Run ThunderID

Get ThunderID running locally. Follow Get ThunderID for download, setup, and start commands.

2

Configure the Server

Add the Wayfinder origin to the server-config cors section. Create or update config/resources/server_configs/cors.yaml, or use PUT /server-config/cors after startup.

Running from source with make run

In development, make run (or .\build.ps1 run on Windows) seeds the Console and Gate origins automatically, so you only need to add the sample app's origin here. Distributions started with start.sh are not seeded; configure all origins manually.

name: cors
value:
  allowedOrigins:
    # ...existing entries...
    - "http://localhost:5173"

Restart ThunderID after editing the declarative resource.

3

Get the Wayfinder Sample

Download the latest Wayfinder sample distribution. It ships with a thunderid-config/ directory containing a declarative YAML bundle and a thunderid.env file with the environment variables it references.

4

Import the Sample Bundle

Apply the bundle through the ThunderID Console. It creates everything the walkthroughs share.

1. Sign in to the ThunderID Console at https://localhost:8090/console.
2. On first sign-in, a welcome screen appears with an Open button. (Later, reach the same screen from the user profile menu in the top-right corner of the Console.)
3. Click Open and select your thunderid-config/redirect/thunderid-config.yaml file from the sample distribution.
4. Select your thunderid-config/redirect/thunderid.env file to provide the environment variables referenced in the YAML.
5. The Console imports the files and reports the resources it created when the import completes.

5

Run the Sample

From the extracted sample directory, install dependencies:

npm install

Then start all services:

npm run dev

The sample opens at http://localhost:5173.

Walkthroughs

Pick a walkthrough to begin. Each one starts from the setup above.

LoginJohn Doe signs in to Wayfinder and arrives at the dashboard.Go to Login →

Self Sign-UpEmma Wilson signs up with email and password.Go to Self Sign-Up →

View ProfileJohn views and updates his profile.Go to View Profile →

Account RecoveryJohn resets a forgotten password through an email link.Go to Account Recovery →

Onboard Internal UsersAlex invites staff members from the console.Go to Onboard Internal Users →

Going Deeper

• Curious how the bundle maps to ThunderID concepts? See Identity Concepts.