Set Up Your Environment

Before you build anything, get ThunderID and the Wayfinder sample running. Every page after this uses them.

Building your own app?

This tutorial builds the Wayfinder sample by hand, so you can see exactly what each concept creates. The names and identifiers here (wayfinder, the Traveler role, John Doe) are Wayfinder's; swap in your own as you go.

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's CORS (cross-origin resource sharing) allowlist, so the browser lets your app call ThunderID from a different origin. 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.

With that running, you're ready to build. Each page from here creates one piece of the setup, starting with your users.