# Getting Started

Use this page to find the right starting point fast.

Most teams follow this order:

1. IT deploys the platform.
2. Admins add members and assign roles.
3. Developers build and upload experiences.
4. Coaches create modules and share the CODE.
5. Participants join and play.

In many education deployments, developers are internal teams, external partners, or students building experiences as part of a course or project.

{% hint style="info" %}
If you are not sure where to start, read [Overview](https://unity.zoeimmersive.com/bridge-xr/start-here/overview) first, then check [Roles & Permissions](https://unity.zoeimmersive.com/bridge-xr/start-here/roles-and-permissions).
{% endhint %}

### Before you begin

* Bridge XR is self-hosted on your own cloud infrastructure.
* Organization members sign in with institution SSO or credentials set by IT.
* Guests can join a module with a CODE and their full name.
* Guest activity is device-based. A new device creates a new entry.
* Experiences can run in the browser through the **web player** or on **Meta Quest** through the installed **Bridge XR App**.

### Quick start by role

{% stepper %}
{% step %}

### IT or platform owner

Set up the platform first.

* Deploy the backend and web dashboard with [Server Deployment](https://unity.zoeimmersive.com/bridge-xr/set-up-bridge-xr/server-deployment).
* Configure identity with [SSO configuration](https://unity.zoeimmersive.com/bridge-xr/set-up-bridge-xr/server-deployment/sso-configuration) and [SSO Integration](https://unity.zoeimmersive.com/bridge-xr/set-up-bridge-xr/server-deployment/sso-integration).
* Distribute the headset app with [Install and Distribute the Bridge XR App](https://unity.zoeimmersive.com/bridge-xr/set-up-bridge-xr/install-and-distribute-the-bridge-xr-app).
  {% endstep %}

{% step %}

### Administrator

Prepare the organization and access.

* Review access levels in [Roles & Permissions](https://unity.zoeimmersive.com/bridge-xr/start-here/roles-and-permissions).
* Add members and manage roles in [Manage Organization and Members](https://unity.zoeimmersive.com/bridge-xr/use-bridge-xr/manage-organization-and-members).
* Confirm developers and coaches have the right access before rollout.
  {% endstep %}

{% step %}

### Developer

Build, prepare, and publish experiences.

{% hint style="info" %}
In many educational institutions, this role is often handled by students building experiences as part of a course, studio, or project.
{% endhint %}

* Build in Unity with **Zoe for Unity**.
* Add the **Bridge XR integration package** to connect the experience to Bridge XR.
* Add Bridge XR tracking and completion actions.
* Upload builds with [Upload Experiences from Unity](https://unity.zoeimmersive.com/bridge-xr/build-with-unity/upload-experiences-from-unity).
* Test the published version with [Test Published Experiences](https://unity.zoeimmersive.com/bridge-xr/build-with-unity/test-published-experiences).
  {% endstep %}

{% step %}

### Coach or facilitator

Turn published experiences into a playable module.

* Create a module in [Create and Manage Modules](https://unity.zoeimmersive.com/bridge-xr/use-bridge-xr/create-and-manage-modules).
* Add one or more experiences.
* Publish the module and share the CODE with participants.
* Use the same module page to track participants and analytics.
  {% endstep %}

{% step %}

### Participant

Join the module and start playing.

* Open the web dashboard for browser playback or the Bridge XR App for Meta Quest playback.
* Enter the CODE shared by your coach.
* Follow [Join Modules and Play](https://unity.zoeimmersive.com/bridge-xr/use-bridge-xr/join-modules-and-play).
  {% endstep %}
  {% endstepper %}

### Bridge XR terms

* **Experience**: a Unity experience built with Zoe for Unity and connected to Bridge XR.
* **Module**: a shareable collection of experiences for one learning session.
* **Bundle**: the packaged build a developer uploads to the server.

### Which part of Bridge XR do I use?

* **Web Dashboard**: manage members, modules, and analytics. It also includes the **web player** for supported Unity web exports.
* **Bridge XR App**: the installed player for Meta Quest headset experiences.
* **Zoe for Unity + Bridge XR package**: create experiences in Unity, add Bridge XR integration, and publish them to Bridge XR.

### User flow diagram

Use this diagram as a visual overview of the platform flow across roles.

<figure><img src="https://2377590261-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz0pDcUm114qZSWNhbhEt%2Fuploads%2FLFbPjzBrEPcxTzuOglSV%2Fbridge-image7.png?alt=media&#x26;token=64b090e9-3f56-481a-ae3d-26b8bcdd1007" alt="Bridge XR user flow diagram"><figcaption><p>Bridge XR user flow diagram</p></figcaption></figure>
