See It in a Sample App
Wayfinder is the reference implementation for secure consumer access: a customer-facing travel application that runs each journey in this section against ThunderID.
Cast
These sample users appear throughout the walkthroughs, one per journey.
Architecture
The Wayfinder sample has three main parts: a consumer web application, a booking API, and ThunderID as the identity platform. The diagram shows where identity journeys run and where tokens are used after sign-in.
Import the Bundle
The fastest way to create the resources the walkthroughs need. First, set up your environment; then apply the bundle through the ThunderID Console, which creates everything the walkthroughs share.
Prefer to build each resource by hand and understand it as you go? Work through the Build It tutorial instead.
- Sign in to the ThunderID Console at https://localhost:8090/console.
- 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.)
- Click Open and select your
thunderid-config/redirect/thunderid-config.yamlfile from the sample distribution. - Select your
thunderid-config/redirect/thunderid.envfile to provide the environment variables referenced in the YAML. - The Console imports the files and reports the resources it created when the import completes.
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
After the sample is running, pick the journey you want to inspect:
Next Steps
- Go back to Build It to build the same setup by hand, learning each concept as you go.
- Review the Design Decisions & Alternatives behind the pattern.
