REG-01: Register your Device

Use Case: Register your Device

Player App:
As a new Seeker, I want to identify myself using my device, so I can play the game and collect badges.

MobiLoc App:
As a Steward, I want to identify myself using my device, so I can maintain the course and collect badges.


  • Once registered, the device becomes part of your authentication — simply having the device is enough to show who you are.
  • Your email address is the key identifier. There is a confirmation process — which is described in this use case — establishing the desired email address to use for Badging.
  • Only registered devices may play the game or edit the data, so this is the first pre-requisite for many actions. It also establishes each of your sessions on the Clue Ride network.

Design is under Registration Design.

Registration is required for each application on a given device. Registration is also required for multiple devices running the same app. Using the same email address across apps and devices is recommended, but not required.


  • New Member's First install of a given App
  • Existing Member's additional apps on a registered device
  • Existing Member's registration on a new device


  • Application is installed (Download and Install Application)
  • Device is not yet registered; once the app is registered on a given device, the opportunity to register is no longer provided.

NOTE: For debugging purposes, it is possible to un-register a device. There isn't a way to remotely un-register at this time.


Also see Identify Yourself

  1. Open the application. For unregistered devices, one of the few choices available after opening the app is to register the device. As explained on this opening page, your email address is used for awarding achievement badges. There are two ways of supplying this email address:
    1. Choosing the one associated with either a Google account or Facebook account (social login)
    2. Manually enter your email address and verify that address by supplying a password

The Social Login is the preferred method for not having to remember another password

  1. After choosing whether to login via Google or Facebook or to enter a separate email/password combo, you're taken to the appropriate screen that allows you to register.
    1. Social login returns and shows the email address chosen. An opportunity is provided to choose a different account / email, or even choose to enter a specific email.
    2. Entry of a specific email follows Identify Yourself
  2. Successful registration brings you to the welcome page of the application which displays indications of your identity (including your photo if available).

Alternative Paths

New install on a new device: no differences?

New install on a given device: no differences?


For the user:

  • They have access to all functionality that matches their role and achievement level.

On the System:

  • JWT token — provides User details such as an image and the email address.
  • Renewal Token
  • Access token — represents the open session and is included in the Auth header for all "Secured" requests.
  • Device ID (provided by Ionic's Platform API) for detecting device changes.
  • Member's principal (email address)
  • Link is established between:
    • the Member's credentials (email address) and
    • the Principal that represents the Member and
    • the WordPress / BuddyPress account



Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-ShareAlike 3.0 License