Setting Up a Demo App
Use this guide to set up a Wristband demo app and explore how it works.
New to Wristband? This guide helps you set up a demo application to explore how Wristband functions.
Available Demo AppsCheck out our Example Apps Page to see the full list of supported frameworks.
More languages and frameworks are coming soon. Have a specific request? Let us know.
The Create App Modal
Kickstart your Wristband integration by running a demo app locally. Use these apps as templates and copy the code straight into your project!
Go to the Wristband dashboard home page and click Add Application to get started.
Figure1: Home Page: Add Application Button
Choosing the Demo App Type
Choose Try Demo App when prompted to select an application type, then click Continue.
Figure 2:Add App Modal: Choose demo application type
Choosing Your Subject Kind
Select the type of subject requiring authentication. Your choice depends on whether you are issuing access tokens to humans or backend services.
Figure 3: Add App Modal: Choose whether users or machines will authenticate
Authenticating Users
Select Humans if people will log in via Wristband's hosted login pages. This issues access tokens, OpenID-compliant ID tokens, and refresh tokens to keep user sessions running smoothly.
Authenticating Machines
Select Machines for automated services. The system will call the Wristband Token Endpoint at startup for an access token. No ID or refresh tokens are provided since this is a machine-to-machine setup.
Choosing Your Application Framework
After selecting the authentication subject, choose your preferred application framework. The available options adjust based on your previous selection.
Figure 4: Add App Modal: Choose your demo application framework
Provisioning the Demo App
Configure your demo app, then review the preview of entities Wristband will create. Click Create to provision them.
Copying Values Into Environment Variables
After creation, you'll see a link to the demo app's GitHub repository and a set of copyable string values.
Figure 5: Add App Modal: Values to copy into the environment variable configuration of the demo app
Clone the repository and copy the string values from the modal into the .env file in your demo app repository. Example showing where to insert these values:
Figure 6: Example of the environment variable configuration for a demo app.
Updated 10 days ago