Skip to content

BrightID Full Mobile Spec

Adam Stallard edited this page Nov 23, 2018 · 36 revisions


BrightID has two main uses:

  • To help users become verified as a unique individual
  • To connect users to apps that offer added benefits for being verified as unique

Individuality Score

A user's individuality score (also called a “brightID score” or just “score”) is what applications look at to determine that a user only has one account in their system--the higher the score (on a scale of 0 to 100), the higher the likelihood that the user exists only once in the system. Different apps may have different score requirements. If an user’s score is too low, it’s an indication of duplicate accounts, and they may be blocked from using the app.

To receive a score, a user must belong to one or more groups. Each group has its own score. The score of a user’s highest-scoring group becomes a user's individual score. This means that belonging to more groups has the potential to raise one's score.

Groups can be created with as few as three users..


  • When you first run BrightID, you will see an onboarding flow. There will be items in a carousel that include an icon, a heading and subtext.
  • Clicking Get Started will take the user to the sign up screen.
Mockup 1
Onboarding Flow

Sign up

  • The user will be asked to add a photo and enter their name. This is what will be sent to other users to help them manage their connections.
  • The user's name and image won't be stored on servers or sent to apps.
  • Clicking the ? icon will take the user back to the Onboarding screen.
Mockup 2
Sign up


Display the following:

  • Avatar
  • Name
  • Score
  • Number of connections
  • Number of groups
  • Connect (action)
Mockup 3

Making a Connection

Connections can be established by two people by meeting in person, or over video chat.

  • Both users need to have the BrightID app installed.
  • One user will click "create" to generate an on-screen QR code
Mockup 4
  • The other user will scan the code.
Mockup 5
Scan QR Connection
  • After the users confirm that the name and photo of the other user matches what's expected, the connection is created.


In the Connections tab, the user's current connections will be displayed. Clicking the action menu next to the connection will open a menu. One of the options will be "Remove Connection"

Suggested Usage: The user is expected to review their connections for duplicates. Connections are ordered such that two similar connections will appear next to each other. If there's a duplicate in their connections, they should arrange a meeting in person and see which connection comes up when they use the BrightID app, and remove the other one. If it's impossible to meet in person, it is suggested to remove both connections. The users need to beware of individuals they don't know well attempting to make a connection -- especially if they do so in a way that bypasses the normal, in-person operation of BrightID.

Mockup 6


The Groups screen will display eligible groups, current groups, ability to search, and a way to create new groups.

Mockup 7
  • Once the user has made enough connections to existing members of a group, the user will be automatically invited to join. The group will appear in the Eligible section of the groups tab. Once the user joins, it will move to the Current section.
  • If "X" is selected for a group, it's buried at the bottom of the "eligible" list in case the user changes their mind.
  • Eligible Groups are marked "awaiting co-founders" if not all the founders have joined yet. The creator of the group is automatically joined. Other founders need to join as normal. Groups in the founding stage don't have a score yet.
    • Clicking on a group that is "awaiting co-founders" takes the user to a "Review Group" screen where groups in the founding stage can be joined or canceled.
      • The original creator sees the message "You have created this group and are awaiting co-founders." and an option to "Cancel Group"
Mockup 8
Group Review - Creator

Other co-founders see the message "You have been invited to co-found a group!" and options to "reject invite" or "accept invite."

Mockup 9
Group Review - Other Founder

Rejecting an invite has a confirmation dialog informing the user that doing so will cancel the group.

Mockup 10
Reject Invite Confirmation

There are four possible displays for eligible groups as show below. The first (A) is a regular group that hasn't been declined or joined. The second (B) is a group in the founding stage where the user is invited by the creator to be a co-founder, but hasn't joined yet. The third (C, D) is a group in the founding stage where the user has joined (or created) the group. The fourth (E) is a regular group the user has declined; these appear at the bottom of the list, but aren't fully removed. Joined groups are moved to the "CURRENT" section.

Mockup 11
Eligible Groups Variations

View Group

  • Group Avatar (auto-generated using the photos of two or three founders or other members known to the user)
  • Group Name (names of two or three founders or other members known to the user)
  • Group Score.
Mockup 12
View Group

View Group - Actions

After clicking the three dots on the View Group screen, an action item will be displayed: Leave Group

Leaving a Group

  • After a user leaves a group, it will move from the Current section to the Eligible section. (The user will be able to join it again)
  • After leaving or being removed from a group, it will no longer influence a user's score.
Mockup 13
Group Action Menu

Group Member - Actions

After clicking the three dots next to a group member, an action item will be displayed: Flag for Removal. The reason can be "Duplicate", "Fake", or "Deceased". A flagged user is marked with a caution icon in group lists and connection lists to alert other users. After being flagged for removal by two group members, a user is removed from a group and can never rejoin it.

Mockup 14
Group Member Actions

Create Group

Select Co-founders

To create a group, the user will click the "plus" icon on the Groups screen. Each group is uniquely identified by its three co-founders, i.e. three co-founders can't create more than one group. The group's creator will choose two co-founders from their list of connections.

Mockup 15
Group Co-Founders

Authorizing other Applications

A user can grant other applications the ability to look up their score (without needing to share any other information such as name or photo). That application can then extend privileges based on the score.

There are best-practices for applications to help them avoid associating brightID public keys with information that could expose someone's real identity--such as names or chat logs.

You can’t perform that action at this time.