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

Edit repository/conf/deployment.yaml and add the Wayfinder origin under cors.allowed_origins. Leave any existing entries in place.

cors:
  allowed_origins:
    # ...existing entries...
    - "http://localhost:5173"

Restart ThunderID after the change.

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/thunderid-config.yaml file from the sample distribution.
4. Select your thunderid-config/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

Start all Wayfinder services from the extracted sample directory:

Linux / macOS

./start.sh

Windows

.\start.ps1

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.